Places Autocomplete Service

คลาส AutocompleteService

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

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

เข้าถึงโดยโทรไปที่ const {AutocompleteService} = await google.maps.importLibrary("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
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 ก็ได้
locationBias optional
ประเภท:  LocationBias optional
ขอบเขตแบบนุ่มนวลหรือคำใบ้ที่ใช้ในการค้นหาสถานที่
locationRestriction optional
ประเภท:  LocationRestriction optional
เป็นขอบเขตเพื่อจำกัดผลการค้นหา
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
predictions
ประเภท:  Array<AutocompletePrediction>
รายการของ AutocompletePrediction

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

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

คำขอการเติมข้อความอัตโนมัติที่จะส่งไปยัง QueryAutocompleteService
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 รายการเดียว

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

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

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

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

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

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

แสดงการคาดคะเนเพื่อเติมข้อความอัตโนมัติรายการเดียว
description
ประเภท:  string
นี่เป็นข้อความค้นหาเวอร์ชันที่ไม่ได้จัดรูปแบบที่แนะนำโดยบริการ Places
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

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

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

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

แสดงคำที่คาดคะเน
offset
ประเภท:  number
ค่าออฟเซ็ตในอักขระ Unicode ของจุดเริ่มต้นของคำนี้ในคำอธิบายของสถานที่
value
ประเภท:  string
ค่าของคํานี้ เช่น "Taco Bell"

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

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

แสดงสตริงย่อยของการคาดการณ์
length
ประเภท:  number
ความยาวของสตริงย่อย
offset
ประเภท:  number
ค่าออฟเซ็ตกับจุดเริ่มต้นของสตริงย่อยภายในสตริงคำอธิบาย

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

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

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