Autocomplete Data (new)

AutocompleteSuggestion class

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

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

เข้าถึงได้โดยโทรไปที่ const {AutocompleteSuggestion} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
พารามิเตอร์: 
ค่าที่ส่งคืน:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
ดึงข้อมูลรายการ AutocompleteSuggestions

หากมีการระบุ AutocompleteRequest.sessionToken ในคำขอ ระบบจะรวมโทเค็นเซสชันนั้นโดยอัตโนมัติเมื่อเรียกใช้ Place.fetchFields เป็นครั้งแรกในแต่ละ Place ที่ PlacePrediction.toPlace ส่งคืนใน PlacePrediction ที่เป็นผลลัพธ์
placePrediction
ประเภท:  PlacePrediction optional
มีชื่อที่มนุษย์อ่านได้สำหรับผลลัพธ์ที่แสดง สำหรับผลการค้นหาของสถานประกอบการ โดยปกติแล้วจะเป็นชื่อและที่อยู่ของธุรกิจ

หากมีการระบุ AutocompleteRequest.sessionToken ใน AutocompleteRequest ที่ใช้เพื่อดึง AutocompleteSuggestion นี้ ระบบจะรวมโทเค็นเดียวกันโดยอัตโนมัติเมื่อเรียกใช้ Place.fetchFields เป็นครั้งแรกใน Place ที่ส่งคืนโดยการเรียกใช้ PlacePrediction.toPlace

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

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

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

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

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

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

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

เมื่อมีการระบุโทเค็นเซสชันในคำขอไปยัง AutocompleteSuggestion.fetchAutocompleteSuggestions ระบบจะรวมโทเค็นเดียวกันโดยอัตโนมัติในการเรียกครั้งแรกเพื่อดึงข้อมูลฟิลด์ใน Place ที่ส่งคืนโดยการเรียก PlacePrediction.toPlace ใน AutocompleteSuggestion รายการใดรายการหนึ่งที่ได้

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

AutocompleteSessionToken class

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

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

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

PlacePrediction class

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>
รายการประเภทที่ใช้กับสถานที่นี้จากตาราง A หรือตาราง B ใน https://developers.google.com/maps/documentation/places/web-service/place-types
BetafetchAddressValidation
fetchAddressValidation(request)
พารามิเตอร์: 
ค่าที่ส่งคืน:  Promise<AddressValidation>
ส่งคำขอการตรวจสอบที่อยู่ซึ่งเชื่อมโยงกับเซสชันการเติมข้อความอัตโนมัตินี้ (ภายในจะมีการป้อนข้อมูลคำขอด้วยโทเค็นเซสชันการเติมข้อความอัตโนมัติ) ระบบจะไม่รวมข้อมูลสถานที่จาก PlacePrediction โดยอัตโนมัติ ซึ่งเป็นวิธีที่สะดวกในการช่วยจัดการเซสชันการเติมข้อความอัตโนมัติ
toPlace
toPlace()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Place
แสดงผลการแสดง Place ของ PlacePrediction นี้ คุณต้องโทรไปยัง Place.fetchFields ในภายหลังเพื่อรับรายละเอียดสถานที่แบบเต็ม

หากมีการระบุ AutocompleteRequest.sessionToken ใน AutocompleteRequest ที่ใช้ในการดึงข้อมูล PlacePrediction นี้ ระบบจะรวมโทเค็นเดียวกันโดยอัตโนมัติเมื่อเรียกใช้ fetchFields

หรือเมื่อใช้PlaceAutocompleteElement การเรียกครั้งแรกไปยัง Place.fetchFields ใน Place ที่ PlacePrediction.toPlace ส่งคืนมาจะรวมโทเค็นเซสชันโดยอัตโนมัติ

StringRange class

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

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

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

FormattableText class

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