Places Autocomplete Service

AutocompleteService class

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)
พารามิเตอร์: 
ค่าที่ส่งคืน: ไม่มี
เรียกข้อมูลการคาดคะเนการเติมข้อความอัตโนมัติของคำค้นหาตามคำขอการเติมข้อความอัตโนมัติของคำค้นหาที่ระบุ

AutocompletionRequest interface

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
รหัสภูมิภาคที่ใช้สำหรับการจัดรูปแบบผลลัพธ์และการกรองผลลัพธ์ แต่ไม่ได้จำกัดการแนะนำไว้เฉพาะในประเทศนี้ รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") ที่มีอักขระ 2 ตัว รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 แต่ก็มีข้อยกเว้นที่สำคัญบางประการ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
sessionToken optional
ประเภท:  AutocompleteSessionToken optional
การอ้างอิงที่ไม่ซ้ำกันซึ่งใช้ในการจัดกลุ่มคำขอแต่ละรายการเป็นเซสชัน
types optional
ประเภท:  Array<string> optional
ประเภทของการคาดการณ์ที่จะแสดง ดูประเภทที่รองรับได้ใน คู่มือสำหรับนักพัฒนาซอฟต์แวร์ หากไม่ได้ระบุประเภท ระบบจะแสดงผลประเภททั้งหมด

AutocompleteResponse interface

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

การตอบกลับการเติมข้อความอัตโนมัติที่การเรียกใช้ AutocompleteService.getPlacePredictions แสดงผล ซึ่งมีรายการ AutocompletePrediction
predictions
ประเภท:  Array<AutocompletePrediction>
รายการ AutocompletePrediction

QueryAutocompletionRequest interface

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

คำขอ QueryAutocompletion ที่จะส่งไปยัง 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 ก็ได้

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

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

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

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

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

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

PredictionSubstring interface

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

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

StructuredFormatting interface

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

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