Places Autocomplete Service

AutocompleteService class

google.maps.places.AutocompleteService class

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

เข้าถึงโดยการโทรหา 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 interface

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

คำขอเติมข้อความอัตโนมัติที่จะส่งไปยัง AutocompleteService.getPlacePredictions
input
ประเภท:  string
สตริงอินพุตที่ผู้ใช้ป้อน
bounds optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตสำหรับการโน้มเอียงในการคาดการณ์ การคาดการณ์จะเอนเอียงไปทาง bounds ที่ระบุ แต่ไม่ได้จำกัดเพียง 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 อินเทอร์เฟซ

คำขอ QueryAutocompletion ที่จะส่งไปยัง QueryAutocompleteService
input
ประเภท:  string
สตริงอินพุตที่ผู้ใช้ป้อน
bounds optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตสำหรับการโน้มเอียงในการคาดการณ์ การคาดการณ์จะเอนเอียงไปทาง bounds ที่ระบุ แต่ไม่ได้จำกัดเพียง bounds ดังกล่าว ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ไว้
location optional
ประเภท:  LatLng optional
ตำแหน่งสำหรับการโน้มเอียงการคาดการณ์ การคาดการณ์จะเอนเอียงไปทาง location และ radius ที่ระบุ หรือจะใช้ bounds ก็ได้
offset optional
ประเภท:  number optional
ตำแหน่งอักขระในคำที่ป้อนซึ่งบริการใช้ข้อความสำหรับการคาดคะเน (ตำแหน่งเคอร์เซอร์ในช่องป้อนข้อมูล)
radius optional
ประเภท:  number optional
รัศมีของพื้นที่ที่ใช้สำหรับการคาดการณ์แบบลำเอียง radius จะระบุเป็นเมตรและต้องมาพร้อมกับพร็อพเพอร์ตี้ location เสมอ หรือจะใช้ bounds ก็ได้

ComponentRestrictions interface

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 interface

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

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

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