Places Autocomplete Service

AutocompleteService class

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

เลิกใช้งานแล้ว: ตั้งแต่วันที่ 1 มีนาคม 2025 เป็นต้นไป google.maps.places.AutocompleteService จะไม่มีให้บริการแก่ลูกค้าใหม่ โปรดใช้ AutocompleteSuggestion แทน ขณะนี้ยังไม่มีกำหนดการเลิกใช้งาน google.maps.places.AutocompleteService แต่ขอแนะนำให้ใช้ AutocompleteSuggestion แทน google.maps.places.AutocompleteService แม้ว่า google.maps.places.AutocompleteService จะยังคงได้รับการแก้ไขข้อบกพร่องสำหรับการถดถอยที่สำคัญ แต่ข้อบกพร่องที่มีอยู่ใน google.maps.places.AutocompleteService จะไม่ได้รับการแก้ไข เราจะแจ้งให้ทราบล่วงหน้าอย่างน้อย 12 เดือนก่อนที่จะหยุดให้บริการ โปรดดูรายละเอียดเพิ่มเติมที่ https://developers.google.com/maps/legacy และดูคำแนะนำในการย้ายข้อมูลที่ https://developers.google.com/maps/documentation/javascript/places-migration-overview

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

เข้าถึงได้โดยโทรไปที่ 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 A callback accepting an array of QueryAutocompletePrediction objects and a PlacesServiceStatus value as argument. ค่าที่ส่งคืน: ไม่มี เรียกข้อมูลการคาดคะเนการเติมข้อความอัตโนมัติของคำค้นหาตามคำขอการเติมข้อความอัตโนมัติของคำค้นหาที่ระบุ

AutocompletionRequest interface

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 ("โดเมนระดับบนสุด") ที่มีอักขระ 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 แนะนำ โดยปกติจะเป็นตำแหน่งของสถานที่