Places Autocomplete Service

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

AutocompleteService คลาส

google.maps.places.AutocompleteService ชั้น

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

ต้องระบุพารามิเตอร์ของ URL &libraries=places ดูไลบรารีใน Maps JavaScript API

AutocompleteService
AutocompleteService()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ AutocompleteService
getPlacePredictions
getPlacePredictions(request[, callback])
พารามิเตอร์:
  • requestAutocompletionRequest คําขอการเติมข้อมูลอัตโนมัติ
  • 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
ตัวระบุภาษาสําหรับภาษาที่ควรจะส่งคืนผลลัพธ์หากเป็นไปได้ ผลการค้นหาในภาษาที่เลือกอาจอยู่ในอันดับสูงกว่า แต่คําแนะนําจะไม่จํากัดเฉพาะภาษานี้ ดูรายชื่อภาษาที่รองรับ
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 โดยมีข้อยกเว้นบางประการที่ชัดเจน ตัวอย่างเช่น สหราชอาณาจักร's 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

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

อินเทอร์เฟซ 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 สตริง

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

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

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

ต้องระบุพารามิเตอร์ของ URL &libraries=places ดูไลบรารีใน Maps JavaScript API

description
ประเภท: string
ข้อความค้นหานี้เป็นรูปแบบที่ไม่ได้จัดรูปแบบซึ่งแนะนําโดยบริการสถานที่
matched_substrings
ประเภท: Array<PredictionSubstring>
ชุดสตริงย่อยในคําอธิบายสถานที่ที่ตรงกับองค์ประกอบในอินพุตของผู้ใช้ เหมาะสําหรับใช้ไฮไลต์สตริงย่อยเหล่านั้น สตริงย่อยแต่ละรายการจะระบุโดยออฟเซ็ตและความยาว ซึ่งแสดงด้วยอักขระ Unicode
place_id
ประเภท: string
รหัสสถานที่ที่สามารถใช้เพื่อดึงรายละเอียดเกี่ยวกับสถานที่นี้โดยใช้บริการรายละเอียดสถานที่ (ดู PlacesService.getDetails)
structured_formatting
ประเภท: StructuredFormatting
ข้อมูลที่มีโครงสร้างเกี่ยวกับคําอธิบายสถานที่ แบ่งเป็นข้อความหลักและข้อความรอง รวมถึงอาร์เรย์ของสตริงย่อยที่ตรงกันจากอินพุตการเติมข้อความอัตโนมัติ ซึ่งระบุด้วยค่าชดเชยและความยาว ซึ่งแสดงในอักขระ Unicode
terms
ประเภท: Array<PredictionTerm>
ข้อมูลเกี่ยวกับคําศัพท์แต่ละคําในคําอธิบายข้างต้น เรียงจากมากไปน้อย เช่น "Taco Bell", " Willitis" และ "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
ข้อความค้นหานี้เป็นรูปแบบที่ไม่ได้จัดรูปแบบซึ่งแนะนําโดยบริการสถานที่
matched_substrings
ประเภท: Array<PredictionSubstring>
ชุดสตริงย่อยในคําอธิบายสถานที่ที่ตรงกับองค์ประกอบในอินพุตของผู้ใช้ เหมาะสําหรับใช้ไฮไลต์สตริงย่อยเหล่านั้น สตริงย่อยแต่ละรายการจะระบุโดยออฟเซ็ตและความยาว ซึ่งแสดงด้วยอักขระ Unicode
terms
ประเภท: Array<PredictionTerm>
ข้อมูลเกี่ยวกับคําศัพท์แต่ละคําในคําอธิบายข้างต้น คําตามหมวดหมู่จะมาก่อน (เช่น "ร้านอาหาร") คําศัพท์เกี่ยวกับที่อยู่จะปรากฏจากมากไปน้อย เช่น "San Francisco" และ "CA"
place_id optional
ประเภท: string optional
ใช้ได้เฉพาะเมื่อการคาดคะเนเป็นสถานที่เท่านั้น รหัสสถานที่ที่สามารถใช้เพื่อดึงรายละเอียดเกี่ยวกับสถานที่นี้โดยใช้บริการรายละเอียดสถานที่ (ดู PlacesService.getDetails)

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

อินเทอร์เฟซ 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

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

ต้องระบุพารามิเตอร์ของ URL &libraries=places ดูไลบรารีใน Maps JavaScript API

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