Places Autocomplete Service

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

AutocompleteService คลาส

google.maps.places.AutocompleteService คลาส

มีวิธีที่เกี่ยวข้องกับการเรียกการคาดคะเนการเติมข้อความอัตโนมัติ

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
AutocompleteService
AutocompleteService()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ AutocompleteService
getPlacePredictions
getPlacePredictions(request[, callback])
พารามิเตอร์:
  • request: AutocompletionRequest คําขอเติมข้อมูลอัตโนมัติ
  • callback: function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional การเรียกกลับยอมรับอาร์เรย์ของออบเจ็กต์ AutocompletePrediction และค่า PlacesServiceStatus เป็นอาร์กิวเมนต์
แสดงผลค่า: Promise<AutocompleteResponse>
เรียกการคาดคะเนการเติมข้อความอัตโนมัติโดยอิงตามคําขอการเติมข้อความอัตโนมัติที่ให้ไว้
getQueryPredictions
getQueryPredictions(request, callback)
พารามิเตอร์:
  • request:  QueryAutocompletionRequest คําขอเติมข้อมูลอัตโนมัติในคําค้นหา
  • callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void การเรียกกลับยอมรับอาร์เรย์ของออบเจ็กต์ QueryAutocompletePrediction และค่า PlacesServiceStatus เป็นอาร์กิวเมนต์
ค่าการแสดงผล: ไม่มี
รับการคาดคะเนการเติมข้อความอัตโนมัติจากการค้นหาโดยอิงตามคําขอการเติมข้อความอัตโนมัติในการค้นหาที่ให้ไว้

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

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

คําขอเติมข้อมูลอัตโนมัติจะส่งไปยัง AutocompleteService.getPlacePredictions

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
input
ประเภท: string
ผู้ใช้ป้อนสตริงอินพุต
bounds optional
ประเภท: LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตสําหรับการให้น้ําหนักการคาดการณ์ การคาดการณ์จะได้รับการให้น้ําหนักพิเศษแต่ไม่จํากัดเฉพาะ bounds ที่ระบุ ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ไว้
componentRestrictions optional
ประเภท: ComponentRestrictions optional
ข้อจํากัดของคอมโพเนนต์ ข้อจํากัดของคอมโพเนนต์ใช้เพื่อจํากัดการคาดการณ์ไว้เฉพาะภายในคอมโพเนนต์ระดับบนเท่านั้น เช่น ประเทศ
">language optional
ประเภท: string optional
ตัวระบุภาษาที่ควรใช้ในการแสดงผลการค้นหาหากทําได้ ผลการค้นหาในภาษาที่เลือกอาจได้รับการจัดอันดับสูงกว่า แต่คําแนะนําไม่ได้จํากัดเฉพาะภาษานี้ ดูรายการภาษาที่รองรับ Google อัปเดตภาษาที่รองรับอยู่บ่อยๆ ดังนั้นรายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
location optional
ประเภท: LatLng optional
ตําแหน่งสําหรับอคติการคาดการณ์ การคาดการณ์จะอคติต่อ location และ radius ที่ระบุ หรือจะใช้ bounds ก็ได้
offset optional
ประเภท: number optional
ตําแหน่งของอักขระในคําป้อนข้อมูลที่บริการใช้ข้อความสําหรับการคาดการณ์ (ตําแหน่งของเคอร์เซอร์ในช่องป้อนข้อมูล)
origin optional
ประเภท: LatLng|LatLngLiteral optional
ตําแหน่งที่คํานวณ AutocompletePrediction.distance_meters
radius optional
ประเภท: number optional
รัศมีของพื้นที่ที่ใช้สําหรับการให้น้ําหนักการคาดการณ์ radius มีการระบุหน่วยเป็นเมตร และต้องแสดงพร้อมกับพร็อพเพอร์ตี้ location เสมอ หรือจะใช้ bounds ก็ได้
">region optional
ประเภท: string optional
รหัสภูมิภาคที่ใช้สําหรับการจัดรูปแบบผลการค้นหาและการกรองผลลัพธ์ แต่ไม่ได้จํากัดคําแนะนําไว้สําหรับประเทศนี้ รหัสภูมิภาคยอมรับค่าอักขระ 2 ตัวของ ccTLD ("โดเมนระดับบนสุด") รหัส ccTLD ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สําคัญบางประการ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ในขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสําหรับเอนทิตีของ "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
sessionToken optional
ประเภท: AutocompleteSessionToken optional
ข้อมูลอ้างอิงที่ไม่ซ้ําที่ใช้จัดกลุ่มคําขอแต่ละรายการลงในเซสชัน
types optional
ประเภท: Array<string> optional
ประเภทของการคาดการณ์ที่จะแสดง สําหรับประเภทที่รองรับ โปรดดูคู่มือสําหรับนักพัฒนาซอฟต์แวร์ หากไม่มีการระบุประเภท ระบบจะแสดงผลทุกประเภท

AutocompleteResponse คลาส

google.maps.places.AutocompleteResponse คลาส

การตอบกลับที่เติมข้อความอัตโนมัติโดยการโทรไปที่ AutocompleteService.getPlacePredictions ที่มีรายการ AutocompletePrediction

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
predictions
ประเภท: Array<AutocompletePrediction>
รายชื่อ AutocompletePrediction วินาที

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

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

คําขอเติมข้อมูลอัตโนมัติจะส่งไปยัง QueryAutocompleteService

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
input
ประเภท: string
ผู้ใช้ป้อนสตริงอินพุต
bounds optional
ประเภท: LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตสําหรับการให้น้ําหนักการคาดการณ์ การคาดการณ์จะได้รับการให้น้ําหนักพิเศษแต่ไม่จํากัดเฉพาะ bounds ที่ระบุ ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ไว้
location optional
ประเภท: LatLng optional
ตําแหน่งสําหรับอคติการคาดการณ์ การคาดการณ์จะอคติต่อ location และ radius ที่ระบุ หรือจะใช้ bounds ก็ได้
offset optional
ประเภท: number optional
ตําแหน่งของอักขระในคําป้อนข้อมูลที่บริการใช้ข้อความสําหรับการคาดการณ์ (ตําแหน่งของเคอร์เซอร์ในช่องป้อนข้อมูล)
radius optional
ประเภท: number optional
รัศมีของพื้นที่ที่ใช้สําหรับการให้น้ําหนักการคาดการณ์ radius มีการระบุหน่วยเป็นเมตร และต้องแสดงพร้อมกับพร็อพเพอร์ตี้ location เสมอ หรือจะใช้ bounds ก็ได้

AutocompleteSessionToken คลาส

google.maps.places.AutocompleteSessionToken คลาส

แสดงโทเค็นของเซสชันที่ใช้สําหรับการติดตามเซสชันการเติมข้อความอัตโนมัติ ซึ่งอาจเป็นชุดการโทร AutocompleteService.getPlacePredictions แล้วตามด้วยการเรียก PlacesService.getDetails เพียงครั้งเดียว

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
AutocompleteSessionToken
AutocompleteSessionToken()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ AutocompleteSessionToken

อินเทอร์เฟซ คอมโพเนนต์ข้อจํากัด

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

กําหนดข้อจํากัดของคอมโพเนนต์ที่สามารถใช้กับบริการเติมข้อความอัตโนมัติได้

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
country optional
ประเภท: string|Array<string> optional
จํากัดการคาดคะเนไว้ที่ประเทศที่ระบุ (รหัสประเทศ ISO 3166-1 Alpha-2 ไม่คํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) เช่น 'us', 'br' หรือ 'au' คุณจะระบุสตริงเดียวหรืออาร์เรย์ของสตริงรหัสประเทศได้สูงสุด 5 สตริง

อินเทอร์เฟซการเติมข้อความอัตโนมัติ

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

แสดงถึงการคาดคะเนการเติมข้อความอัตโนมัติรายการเดียว

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
description
ประเภท: string
นี่คือข้อความค้นหาในรูปแบบที่ไม่ได้จัดรูปแบบซึ่งแนะนําโดยบริการ Places
matched_substrings
ประเภท: Array<PredictionSubstring>
ชุดสตริงย่อยในคําอธิบายสถานที่ที่ตรงกับองค์ประกอบในอินพุตของผู้ใช้ เหมาะสําหรับใช้ไฮไลต์สตริงย่อยเหล่านั้น สตริงย่อยแต่ละสตริงระบุด้วยค่าชดเชยและความยาว ซึ่งแสดงในอักขระ Unicode
place_id
ประเภท: string
รหัสสถานที่ซึ่งใช้เพื่อดูรายละเอียดเกี่ยวกับสถานที่นี้ได้โดยใช้บริการรายละเอียดสถานที่ (ดู PlacesService.getDetails)
structured_formatting
ประเภท: StructuredFormatting
Structured Data เกี่ยวกับคําอธิบายสถานที่ โดยจะแบ่งออกเป็นข้อความหลักและข้อความรอง รวมถึงอาร์เรย์ของสตริงย่อยที่ตรงกันจากอินพุตที่เติมข้อความอัตโนมัติ ซึ่งระบุด้วยออฟเซ็ตและความยาว ซึ่งแสดงด้วยอักขระ Unicode
terms
ประเภท: Array<PredictionTerm>
ข้อมูลเกี่ยวกับคําแต่ละคําในคําอธิบายข้างต้นโดยเรียงจากมากไปน้อย เช่น "เชสเตอร์กริลล์" "วิลลิส อักเสบ" และ "CA"
types
ประเภท: Array<string>
อาร์เรย์ของประเภทการคาดคะเน เช่น 'establishment' หรือ 'geocode'
distance_meters optional
ประเภท: number optional
ระยะทางในหน่วยเมตรของสถานที่จาก AutocompletionRequest.origin

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

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

แสดงการคาดคะเนการเติมข้อความอัตโนมัติสําหรับการค้นหารายการเดียว

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
description
ประเภท: string
นี่คือข้อความค้นหาในรูปแบบที่ไม่ได้จัดรูปแบบซึ่งแนะนําโดยบริการ Places
matched_substrings
ประเภท: Array<PredictionSubstring>
ชุดสตริงย่อยในคําอธิบายสถานที่ที่ตรงกับองค์ประกอบในอินพุตของผู้ใช้ เหมาะสําหรับใช้ไฮไลต์สตริงย่อยเหล่านั้น สตริงย่อยแต่ละสตริงระบุด้วยค่าชดเชยและความยาว ซึ่งแสดงในอักขระ Unicode
terms
ประเภท: Array<PredictionTerm>
ข้อมูลเกี่ยวกับแต่ละคําในคําอธิบายข้างต้น อันดับแรกคือคําที่มีการจัดหมวดหมู่ (เช่น "ร้านอาหาร") คําในที่อยู่จะปรากฏจากมากไปน้อย เช่น "ซานฟรานซิสโก" และ "CA"
place_id optional
ประเภท: string optional
ใช้ได้เฉพาะในกรณีที่การคาดคะเนเป็นสถานที่ รหัสสถานที่ซึ่งใช้เพื่อดูรายละเอียดเกี่ยวกับสถานที่นี้ได้โดยใช้บริการรายละเอียดสถานที่ (ดู PlacesService.getDetails)

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

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

แสดงถึงการคาดคะเน

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
offset
ประเภท: number
ออฟเซ็ตเป็นอักขระ Unicode ของคํานี้ในช่วงต้นของคําอธิบายสถานที่
value
ประเภท: string
ค่าของคํานี้ เช่น "Taco Bell"

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

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

แสดงถึงสตริงย่อยในการคาดการณ์

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
length
ประเภท: number
ความยาวของสตริงย่อย
offset
ประเภท: number
ออฟเซ็ตถึงจุดเริ่มต้นของสตริงย่อยภายในสตริงคําอธิบาย

อินเทอร์เฟซแบบการจัดรูปแบบ

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

ประกอบด้วย Structured Data เกี่ยวกับคําอธิบายสถานที่ แบ่งออกเป็นข้อความหลักและข้อความรอง รวมถึงอาร์เรย์ของสตริงย่อยที่ตรงกันจากอินพุตที่เติมข้อความอัตโนมัติ ที่ระบุด้วยออฟเซ็ตและความยาว ซึ่งแสดงในอักขระ Unicode

ต้องมีพารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
main_text
ประเภท: string
นี่คือส่วนข้อความหลักของคําอธิบายสถานที่ที่ไม่ได้จัดรูปแบบของสถานที่ที่แนะนําโดยบริการ Places โดยปกติจะเป็นชื่อสถานที่
main_text_matched_substrings
ประเภท: Array<PredictionSubstring>
ชุดสตริงย่อยในข้อความหลักที่ตรงกับองค์ประกอบในอินพุตของผู้ใช้ เหมาะสําหรับใช้ไฮไลต์สตริงย่อยเหล่านั้น สตริงย่อยแต่ละสตริงระบุด้วยค่าชดเชยและความยาว ซึ่งแสดงในอักขระ Unicode
secondary_text
ประเภท: string
นี่เป็นส่วนข้อความรองของคําอธิบายสถานที่ที่ไม่ได้จัดรูปแบบของสถานที่ที่แนะนําโดยบริการ Places โดยปกติจะเป็นตําแหน่งของสถานที่