Autocomplete Data (new)

อินเทอร์เฟซ AutocompleteRequest

อินเทอร์เฟซของ google.maps.places.AutocompleteRequest

อินเทอร์เฟซคำขอสำหรับ AutocompleteSuggestion.fetchAutocompleteSuggestions
input
ประเภท:  string
สตริงข้อความที่จะค้นหา
includedPrimaryTypes optional
ประเภท:  Array<string> optional
ระบุประเภทสถานที่หลัก (เช่น "ร้านอาหาร" หรือ "gas_station")

ระบบจะแสดงผลสถานที่ต่อเมื่อประเภทหลักรวมอยู่ในรายการนี้เท่านั้น โดยระบุค่าได้สูงสุด 5 ค่า หากไม่ได้ระบุประเภทไว้ ระบบจะแสดงผลประเภทสถานที่ทั้งหมด
includedRegionCodes optional
ประเภท:  Array<string> optional
รวมเฉพาะผลลัพธ์ในภูมิภาคที่ระบุ โดยระบุเป็นรหัสภูมิภาคแบบ 2 อักขระสำหรับ CLDR สูงสุด 15 รายการ ส่วนชุดว่างเปล่าจะไม่จำกัดผลลัพธ์ หากตั้งค่าทั้ง locationRestriction และ includedRegionCodes ผลลัพธ์จะอยู่ในบริเวณสี่แยก
inputOffset optional
ประเภท:  number optional
ออฟเซ็ตอักขระ Unicode แบบศูนย์ของ input ซึ่งระบุตำแหน่งเคอร์เซอร์ใน input ตำแหน่งเคอร์เซอร์อาจมีผลต่อการคาดคะเนที่แสดง หากไม่ได้ระบุ ค่าเริ่มต้นจะเป็นความยาว input
language optional
ประเภท:  string optional
ภาษาที่จะแสดงผลการค้นหา จะมีค่าเริ่มต้นเป็นค่ากำหนดภาษาของเบราว์เซอร์ ผลการค้นหาอาจเป็นภาษาผสมหากภาษาที่ใช้ในinputแตกต่างจากlanguage หรือหากสถานที่ที่ส่งคืนไม่ได้แปลจากภาษาท้องถิ่นเป็นภาษาlanguage
locationBias optional
ประเภท:  LocationBias optional
การให้น้ำหนักผลลัพธ์กับตำแหน่งที่ระบุ

ควรตั้งค่า locationBias หรือ locationRestriction อย่างน้อย 1 รายการ หากไม่ได้ตั้งค่าไว้ ผลลัพธ์จะมีการให้น้ำหนักตามที่อยู่ IP ซึ่งหมายความว่าที่อยู่ IP จะถูกจับคู่กับตำแหน่งที่ไม่แม่นยำและใช้เป็นสัญญาณการให้น้ำหนักพิเศษ
locationRestriction optional
ประเภท:  LocationRestriction optional
จำกัดผลลัพธ์ไปยังตำแหน่งที่ระบุ

ควรตั้งค่า locationBias หรือ locationRestriction อย่างน้อย 1 รายการ หากไม่ได้ตั้งค่าไว้ ผลลัพธ์จะมีการให้น้ำหนักตามที่อยู่ IP ซึ่งหมายความว่าที่อยู่ IP จะถูกจับคู่กับตำแหน่งที่ไม่แม่นยำและใช้เป็นสัญญาณการให้น้ำหนักพิเศษ
origin optional
ประเภท:  LatLng|LatLngLiteral optional
จุดเริ่มต้นที่จะคำนวณระยะห่างทางภูมิศาสตร์ไปยังปลายทาง (แสดงผลเป็น PlacePrediction.distanceMeters) หากละเว้นค่านี้ ระยะทางทางภูมิศาสตร์จะไม่แสดงผล
region optional
ประเภท:  string optional
รหัสภูมิภาคที่ระบุเป็นรหัสภูมิภาคแบบ 2 อักขระของ CLDR ซึ่งจะส่งผลต่อการจัดรูปแบบที่อยู่ การจัดอันดับผลการค้นหา และอาจมีผลต่อผลลัพธ์ที่แสดง การดำเนินการนี้จะไม่จำกัดผลลัพธ์ไปยังภูมิภาคที่ระบุ
sessionToken optional
ประเภท:  AutocompleteSessionToken optional
โทเค็นที่ระบุเซสชันการเติมข้อความอัตโนมัติเพื่อจุดประสงค์ในการเรียกเก็บเงิน สร้างโทเค็นเซสชันใหม่ผ่าน AutocompleteSessionToken

เซสชันจะเริ่มเมื่อผู้ใช้เริ่มพิมพ์คำค้นหา และใช้เวลาสิ้นสุดลงเมื่อเลือกสถานที่และโทรหา Place.fetchFields แต่ละเซสชันสามารถสอบถามได้หลายรายการ ตามด้วยการเรียก fetchFields หนึ่งครั้ง ข้อมูลเข้าสู่ระบบที่ใช้สำหรับแต่ละคำขอภายในเซสชันต้องเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน เมื่อจบเซสชันแล้ว โทเค็นจะใช้ไม่ได้อีกต่อไป แอปของคุณจะต้องสร้างโทเค็นใหม่สำหรับแต่ละเซสชัน หากไม่ใส่พารามิเตอร์ sessionToken หรือหากนำโทเค็นเซสชันมาใช้ซ้ำ ระบบจะเรียกเก็บเงินเซสชันเสมือนว่าไม่ได้ให้โทเค็นเซสชันไว้ (แต่ละคำขอจะถูกเรียกเก็บเงินแยกกัน)

เราขอแนะนำหลักเกณฑ์ต่อไปนี้
  • ใช้โทเค็นเซสชันสำหรับการเรียกที่เติมข้อความอัตโนมัติทุกครั้ง
  • สร้างโทเค็นใหม่สำหรับแต่ละเซสชัน
  • อย่าลืมส่งโทเค็นเซสชันที่ไม่ซ้ำกันสําหรับเซสชันใหม่แต่ละเซสชัน การใช้โทเค็นเดียวกันสำหรับมากกว่า 1 เซสชันจะทำให้แต่ละคำขอถูกเรียกเก็บเงินแยกกัน

AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken ชั้นเรียน

แสดงโทเค็นเซสชันที่ใช้สำหรับการติดตามเซสชันการเติมข้อความอัตโนมัติ

เข้าถึงด้วยการโทรหา const {AutocompleteSessionToken} = await google.maps.importLibrary("places") ดูห้องสมุดใน Maps JavaScript API
AutocompleteSessionToken
AutocompleteSessionToken()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ AutocompleteSessionToken

คลาส AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion ชั้นเรียน

ผลลัพธ์คำแนะนำที่เติมข้อความอัตโนมัติ

เข้าถึงด้วยการโทรหา const {AutocompleteSuggestion} = await google.maps.importLibrary("places") ดูห้องสมุดใน Maps JavaScript API
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
พารามิเตอร์: 
มูลค่าการคืนสินค้า:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
ดึงข้อมูลรายการการเติมข้อความอัตโนมัติที่แนะนำ
placePrediction
ประเภท:  PlacePrediction optional
มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดง สําหรับผลลัพธ์ในสถานประกอบการ โดยปกติแล้วจะเป็นชื่อและที่อยู่ของธุรกิจ

PlacePrediction

google.maps.places.PlacePrediction ชั้นเรียน

ผลการพยากรณ์สำหรับการคาดคะเนการเติมข้อความอัตโนมัติเกี่ยวกับสถานที่

เข้าถึงด้วยการโทรหา const {PlacePrediction} = await google.maps.importLibrary("places") ดูห้องสมุดใน Maps JavaScript API
distanceMeters
ประเภท:  number optional
ความยาวของเรขาคณิตมีหน่วยเป็นเมตรจาก origin หากระบุ origin
mainText
ประเภท:  FormattableText optional
แสดงชื่อของสถานที่
placeId
ประเภท:  string
ตัวระบุที่ไม่ซ้ำของสถานที่ที่แนะนำ ตัวระบุนี้ใช้ได้ใน API อื่นๆ ที่ยอมรับรหัสสถานที่
secondaryText
ประเภท:  FormattableText optional
แสดงถึงสถานที่เพิ่มเติมซึ่งให้ความชัดเจน (เช่น เมืองหรือภูมิภาค) เพื่อระบุสถานที่เพิ่มเติม
text
ประเภท:  FormattableText
มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดง สําหรับผลลัพธ์ในสถานประกอบการ โดยปกติแล้วจะเป็นชื่อและที่อยู่ของธุรกิจ

text เหมาะสำหรับนักพัฒนาแอปที่ต้องการแสดงองค์ประกอบ UI เดี่ยว นักพัฒนาแอปที่ต้องการแสดงองค์ประกอบ UI 2 องค์ประกอบแยกกันแต่เกี่ยวข้องกันอาจต้องการใช้ PlacePrediction.mainText และ PlacePrediction.secondaryText แทน
types
ประเภท:  Array<string>
รายการประเภทที่ใช้กับสถานที่นี้จากตาราง ก หรือตาราง ข ใน https://developers.google.com/maps/documentation/places/web-service/place-types
toPlace
toPlace()
พารามิเตอร์: ไม่มี
มูลค่าการคืนสินค้า:  Place
แสดงผลสถานที่ของ PlacePrediction นี้ ต้องโทรหา Place.fetchFields ในภายหลังเพื่อขอรับรายละเอียดสถานที่ทั้งหมด

StringRange

google.maps.places.StringRange ชั้นเรียน

ระบุสตริงย่อยภายในข้อความที่ระบุ

เข้าถึงด้วยการโทรหา const {StringRange} = await google.maps.importLibrary("places") ดูห้องสมุดใน Maps JavaScript API
endOffset
ประเภท:  number
ออฟเซ็ตแบบศูนย์ของอักขระ Unicode สุดท้ายของสตริงย่อย (ไม่รวม)
startOffset
ประเภท:  number
ออฟเซ็ตแบบศูนย์ของอักขระ Unicode แรกของสตริงย่อย (รวม)

FormattableText

google.maps.places.FormattableText ชั้นเรียน

ข้อความที่แสดงการคาดคะเนสถานที่ ข้อความอาจใช้ตามที่เป็นหรือจัดรูปแบบได้

เข้าถึงด้วยการโทรหา const {FormattableText} = await google.maps.importLibrary("places") ดูห้องสมุดใน Maps JavaScript API
matches
ประเภท:  Array<StringRange>
รายการช่วงสตริงที่ระบุตำแหน่งที่ตรงกับคำขออินพุตใน FormattableText.text คุณใช้ช่วงเพื่อจัดรูปแบบส่วนที่เฉพาะเจาะจงของ text ได้ สตริงย่อยอาจไม่ใช่การจับคู่ที่ตรงกันทั้งหมดของ AutocompleteRequest.input หากการจับคู่ดังกล่าวกำหนดตามเกณฑ์อื่นนอกเหนือจากการจับคู่สตริง (เช่น การแก้ไขการสะกดหรือการถอดเสียง) ค่าเหล่านี้เป็นออฟเซ็ตอักขระ Unicode ของ FormattableText.text ช่วงได้รับการเรียงลำดับตามค่าออฟเซ็ตที่เพิ่มขึ้น
text
ประเภท:  string
ข้อความที่อาจใช้ตามที่เป็นอยู่หรือจัดรูปแบบด้วย FormattableText.matches