Autocomplete Data (new)

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 หรือหากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะเรียกเก็บเงินสำหรับเซสชันราวกับว่าไม่มีการระบุโทเค็นเซสชัน (ระบบจะเรียกเก็บเงินสำหรับคำขอแต่ละรายการแยกกัน) เราขอแนะนำให้ทำตามหลักเกณฑ์ต่อไปนี้ ใช้โทเค็นเซสชันสำหรับการเรียกใช้การเติมข้อความอัตโนมัติของสถานที่ทั้งหมด สร้างโทเค็นใหม่สำหรับแต่ละเซสชัน อย่าลืมส่งโทเค็นเซสชันที่ไม่ซ้ำกันสำหรับเซสชันใหม่แต่ละเซสชัน การใช้โทเค็นเดียวกันสำหรับเซสชันมากกว่า 1 รายการจะส่งผลให้ระบบเรียกเก็บเงินสำหรับคำขอแต่ละรายการแยกกัน

AutocompleteSessionToken class

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

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

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

ผู้ผลิต
AutocompleteSessionToken	AutocompleteSessionToken() พารามิเตอร์: ไม่มี สร้างอินสแตนซ์ใหม่ของ AutocompleteSessionToken

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

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

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

เมธอด
toPlace	toPlace() พารามิเตอร์: ไม่มี ค่าที่ส่งคืน:  Place แสดงผลการแสดงสถานที่ของ PlacePrediction นี้ คุณต้องโทรไปยัง Place.fetchFields ในภายหลังเพื่อรับรายละเอียดสถานที่แบบเต็ม

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