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	เลิกใช้งาน: 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 รหัสภูมิภาคซึ่งใช้สำหรับการจัดรูปแบบผลลัพธ์และการกรองผลลัพธ์ ไม่จำกัดการแนะนำประเทศนี้ รหัสภูมิภาคยอมรับค่า 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 นี่คือส่วนข้อความรองของคำอธิบายที่ไม่ได้จัดรูปแบบของสถานที่ซึ่งบริการสถานที่แนะนำ โดยทั่วไปคือตำแหน่งของสถานที่