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 โค้ดเรียกกลับที่ยอมรับอาร์เรย์ของออบเจ็กต์ AutoAutocompletePrediction และค่า PlacesServiceStatus เป็นอาร์กิวเมนต์ ค่าที่ส่งกลับ: ไม่มี รับการคาดคะเนการเติมข้อความค้นหาอัตโนมัติโดยอิงตามคําขอการเติมข้อความอัตโนมัติในการค้นหา

AutocompletionRequest

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

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

พร็อพเพอร์ตี้
input	ประเภท:  string ผู้ใช้ป้อนสตริงที่ป้อน
bounds optional	เลิกใช้งาน: bounds เลิกใช้งานแล้วตั้งแต่เดือนพฤษภาคม 2023 โปรดใช้ AutocompletionRequest.locationBias และ AutocompletionRequest.locationRestriction แทน ประเภท:  LatLngBounds|LatLngBoundsLiteral optional ขอบเขตสําหรับการให้น้ําหนักการคาดการณ์ การคาดการณ์จะเอนเอียงไปทาง bounds ที่ระบุแต่ไม่จํากัดเฉพาะ ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ไว้
componentRestrictions optional	ประเภท:  ComponentRestrictions optional ข้อจํากัดของคอมโพเนนต์ ข้อจํากัดของคอมโพเนนต์ใช้เพื่อจํากัดเฉพาะการคาดการณ์ภายในคอมโพเนนต์ระดับบนสุดเท่านั้น เช่น ประเทศ
language optional	ประเภท:  string optional ตัวระบุภาษาที่ควรใช้ในการส่งกลับผลลัพธ์หากเป็นไปได้ ผลลัพธ์ในภาษาที่เลือกอาจได้รับการจัดอันดับสูงกว่า แต่คําแนะนําจะไม่จํากัดเฉพาะภาษานี้ ดูรายการภาษาที่รองรับ
location optional	เลิกใช้งาน: location เลิกใช้งานแล้วตั้งแต่เดือนพฤษภาคม 2023 โปรดใช้ AutocompletionRequest.locationBias และ AutocompletionRequest.locationRestriction แทน ประเภท:  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	เลิกใช้งาน: radius เลิกใช้งานแล้วตั้งแต่เดือนพฤษภาคม 2023 โปรดใช้ AutocompletionRequest.locationBias และ AutocompletionRequest.locationRestriction แทน ประเภท:  number optional รัศมีของพื้นที่ที่ใช้ในการให้การให้น้ําหนักการคาดการณ์ radius ระบุเป็นค่าเมตร และต้องมีพร็อพเพอร์ตี้ location แนบมาด้วยเสมอ หรือจะใช้ bounds ก็ได้
region optional	ประเภท:  string optional รหัสภูมิภาคที่ใช้สําหรับการจัดรูปแบบผลลัพธ์และสําหรับการกรองผลลัพธ์ ไม่จํากัดคําแนะนําเฉพาะในประเทศนี้ รหัสภูมิภาคยอมรับค่าที่เป็นอักขระ 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> ข้อมูลเกี่ยวกับคําศัพท์แต่ละคําในคําอธิบายด้านบน คําตามหมวดหมู่เป็นคําแรก (เช่น "ร้านอาหาร") คําแสดงที่อยู่จากมากไปน้อย เช่น "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 ออฟเซ็ตไปยังสตริงย่อยที่เริ่มต้นภายในสตริงคําอธิบาย

Structured Format อินเทอร์เฟซ

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

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

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