Places Autocomplete Service (deprecated)

คลาส AutocompleteService

google.maps.places.AutocompleteService คลาส
ไลบรารี "places"

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

const {AutocompleteService} = await google.maps.importLibrary("places");
AutocompleteService
AutocompleteService()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ AutocompleteService
getPlacePredictions
getPlacePredictions(request[, callback])
พารามิเตอร์
  • request: AutocompletionRequest คำขอเติมข้อความอัตโนมัติ
  • callback: function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional Callback ที่ยอมรับอาร์เรย์ของออบเจ็กต์ AutocompletePrediction และค่า PlacesServiceStatus เป็นอาร์กิวเมนต์
ค่าที่แสดงผล: Promise<AutocompleteResponse>
ดึงข้อมูลการคาดคะเนการเติมข้อความอัตโนมัติของสถานที่ตามคำขอเติมข้อความอัตโนมัติที่ระบุ
getQueryPredictions
getQueryPredictions(request, callback)
พารามิเตอร์
  • request: QueryAutocompletionRequest คำขอการเติมข้อความอัตโนมัติสำหรับคำค้นหา
  • callback: function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void Callback ที่ยอมรับอาร์เรย์ของออบเจ็กต์ QueryAutocompletePrediction และค่า PlacesServiceStatus เป็นอาร์กิวเมนต์
ผลลัพธ์: ไม่มี
ดึงข้อมูลการคาดคะเนการเติมข้อความอัตโนมัติตามคำขอการเติมข้อความอัตโนมัติที่ระบุ

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

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

คำขอการเติมข้อความอัตโนมัติที่จะส่งไปยัง AutocompleteService.getPlacePredictions
input
ประเภท: string
สตริงอินพุตที่ผู้ใช้ป้อน
bounds
ไม่บังคับ
ประเภท: LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตสำหรับการให้น้ำหนักการคาดคะเน การคาดคะเนจะอิงตาม bounds ที่ระบุ แต่ไม่จำกัดเพียงเท่านั้น ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ไว้
componentRestrictions
ไม่บังคับ
ประเภท: ComponentRestrictions optional
ข้อจำกัดของคอมโพเนนต์ การจำกัดคอมโพเนนต์ใช้เพื่อจำกัดการคาดคะเนให้แสดงเฉพาะภายในคอมโพเนนต์หลักเท่านั้น เช่น ประเทศ
language
ไม่บังคับ
ประเภท: string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ (หากเป็นไปได้) ผลการค้นหาในภาษาที่เลือกอาจได้รับการจัดอันดับที่สูงขึ้น แต่คำแนะนำไม่ได้จำกัดเฉพาะภาษานี้ ดูรายการภาษาที่รองรับ
location
ไม่บังคับ
ประเภท: LatLng optional
ตำแหน่งสำหรับการให้น้ำหนักพิเศษกับการคาดคะเน การคาดการณ์จะเอนเอียงไปทาง location และ radius ที่ระบุ หรือจะใช้ bounds ก็ได้
locationBias
ไม่บังคับ
ประเภท: LocationBias optional
ขอบเขตหรือคำแนะนำแบบคร่าวๆ ที่จะใช้เมื่อค้นหาสถานที่
locationRestriction
ไม่บังคับ
ประเภท: LocationRestriction optional
ขอบเขตเพื่อจำกัดผลการค้นหา
offset
ไม่บังคับ
ประเภท: number optional
ตำแหน่งอักขระในคำที่ป้อนซึ่งบริการใช้ข้อความสำหรับการคาดคะเน (ตำแหน่งของเคอร์เซอร์ในช่องป้อนข้อมูล)
origin
ไม่บังคับ
ประเภท: LatLng|LatLngLiteral optional
สถานที่ที่ใช้คำนวณ AutocompletePrediction.distance_meters
radius
ไม่บังคับ
ประเภท: number optional
รัศมีของพื้นที่ที่ใช้สำหรับการให้น้ำหนักการคาดคะเน radius มีหน่วยเป็นเมตร และต้องมาพร้อมกับพร็อพเพอร์ตี้ location เสมอ หรือจะใช้ bounds ก็ได้
region
ไม่บังคับ
ประเภท: string optional
รหัสภูมิภาคที่ใช้สำหรับการจัดรูปแบบผลลัพธ์และการกรองผลลัพธ์ แต่ไม่ได้จำกัดคำแนะนำไว้เฉพาะในประเทศนี้ รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับหน่วยงาน "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
sessionToken
ไม่บังคับ
ประเภท: AutocompleteSessionToken optional
ข้อมูลอ้างอิงที่ไม่ซ้ำกันซึ่งใช้เพื่อรวมคำขอแต่ละรายการไว้ในเซสชัน
types
ไม่บังคับ
ประเภท: 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
ไม่บังคับ
ประเภท: LatLngBounds|LatLngBoundsLiteral optional
ขอบเขตสำหรับการให้น้ำหนักการคาดคะเน การคาดคะเนจะอิงตาม bounds ที่ระบุ แต่ไม่จำกัดเพียงเท่านั้น ระบบจะไม่สนใจทั้ง location และ radius หากตั้งค่า bounds ไว้
location
ไม่บังคับ
ประเภท: LatLng optional
ตำแหน่งสำหรับการให้น้ำหนักพิเศษกับการคาดคะเน การคาดการณ์จะเอนเอียงไปทาง location และ radius ที่ระบุ หรือจะใช้ bounds ก็ได้
offset
ไม่บังคับ
ประเภท: number optional
ตำแหน่งอักขระในคำที่ป้อนซึ่งบริการใช้ข้อความสำหรับการคาดคะเน (ตำแหน่งของเคอร์เซอร์ในช่องป้อนข้อมูล)
radius
ไม่บังคับ
ประเภท: number optional
รัศมีของพื้นที่ที่ใช้สำหรับการให้น้ำหนักการคาดคะเน radius มีหน่วยเป็นเมตร และต้องมาพร้อมกับพร็อพเพอร์ตี้ location เสมอ หรือจะใช้ bounds ก็ได้

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

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

กำหนดข้อจำกัดของคอมโพเนนต์ที่ใช้กับบริการเติมข้อความอัตโนมัติได้
country
ไม่บังคับ
ประเภท: 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", "Willitis" และ "CA"
types
ประเภท: Array<string>
อาร์เรย์ของประเภทที่การคาดคะเนเป็นของ เช่น 'establishment' หรือ 'geocode'
distance_meters
ไม่บังคับ
ประเภท: 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
ไม่บังคับ
ประเภท: 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
นี่คือส่วนข้อความหลักของคำอธิบายที่ไม่มีการจัดรูปแบบของสถานที่ซึ่งแนะนำโดยบริการ Places โดยปกติจะเป็นชื่อสถานที่
main_text_matched_substrings
ประเภท: Array<PredictionSubstring>
ชุดสตริงย่อยในข้อความหลักที่ตรงกับองค์ประกอบในอินพุตของผู้ใช้ ซึ่งเหมาะสำหรับใช้ในการไฮไลต์สตริงย่อยเหล่านั้น สตริงย่อยแต่ละรายการจะระบุด้วยออฟเซ็ตและความยาว ซึ่งแสดงเป็นอักขระ Unicode
secondary_text
ประเภท: string
นี่คือส่วนข้อความรองของคำอธิบายที่ไม่มีการจัดรูปแบบของสถานที่ที่บริการ Places แนะนำ โดยปกติแล้วจะเป็นตำแหน่งของสถานที่