Autocomplete Data (new)

AutocompleteSuggestion class

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

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

เข้าถึงได้โดยโทรไปที่ const {AutocompleteSuggestion} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

เมธอดแบบคงที่

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) พารามิเตอร์:  autocompleteRequest:  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

เมธอด
fetchAddressValidation	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น fetchAddressValidation(request) พารามิเตอร์:  request:  AddressValidationRequest ค่าที่ส่งคืน: ไม่มี ส่งคำขอการตรวจสอบที่อยู่ซึ่งเชื่อมโยงกับเซสชันการเติมข้อความอัตโนมัตินี้ (ภายในจะมีการป้อนข้อมูลคำขอด้วยโทเค็นเซสชันการเติมข้อความอัตโนมัติ) ระบบจะไม่รวมข้อมูลสถานที่จาก 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