Places Widgets

คลาส PlaceAutocompleteElement

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

การใช้งาน AutocompleteView สำหรับ Places API

ชั้นเรียนนี้ใช้ PlaceAutocompleteElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") ดูไลบรารีใน Maps JavaScript API
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
พารามิเตอร์: 
element optional
ประเภท:  HTMLElement|SVGElement optional
ช่องนี้เป็นแบบอ่านอย่างเดียว องค์ประกอบ DOM สนับสนุนมุมมอง
inputElement
ประเภท:  HTMLInputElement
องค์ประกอบอินพุตที่จะแสดงการเติมข้อความอัตโนมัติ
รับค่าเดิม: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
addListener
addListener(eventName, handler)
พารามิเตอร์: 
  • eventName:  string
  • handler:  Function
ค่าที่ส่งคืน:  MapsEventListener
เพิ่มฟังก์ชัน Listener ที่ระบุลงในชื่อเหตุการณ์ที่กำหนด
gmp-placeselect
function(place)
อาร์กิวเมนต์: 
เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้เลือกการคาดคะเนสถานที่ แสดงผลออบเจ็กต์สถานที่
gmp-requesterror
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อคำขอที่ส่งไปยังแบ็กเอนด์ถูกปฏิเสธ (เช่น คีย์ API ไม่ถูกต้อง) กิจกรรมนี้จะไม่แสดงเป็นบับเบิล

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

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

ตัวเลือกสำหรับการสร้าง PlaceAutocompleteElement
inputElement
ประเภท:  HTMLInputElement
องค์ประกอบอินพุตที่จะแสดงการเติมข้อความอัตโนมัติ
componentRestrictions optional
ประเภท:  ComponentRestrictions optional
ข้อจำกัดของคอมโพเนนต์ ข้อจำกัดของคอมโพเนนต์ใช้เพื่อจำกัดการคาดการณ์ไว้เฉพาะการคาดคะเนที่อยู่ในคอมโพเนนต์หลักเท่านั้น เช่น ประเทศ
element optional
ประเภท:  HTMLElement|SVGElement optional
ช่องนี้เป็นแบบอ่านอย่างเดียว องค์ประกอบ DOM สนับสนุนมุมมอง
locationBias optional
ประเภท:  LocationBias optional
ขอบเขตแบบนุ่มนวลหรือคำใบ้ที่ใช้ในการค้นหาสถานที่
locationRestriction optional
ประเภท:  LocationRestriction optional
เป็นขอบเขตเพื่อจำกัดผลการค้นหา
requestedLanguage optional
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ หากเป็นไปได้ ผลการค้นหาในภาษาที่เลือกอาจได้รับการจัดอันดับที่สูงขึ้น แต่คำแนะนำจะไม่จำกัดเป็นภาษานี้ ดูรายการภาษาที่รองรับ
requestedRegion optional
ประเภท:  string optional
รหัสภูมิภาคซึ่งใช้สำหรับการจัดรูปแบบผลลัพธ์และการกรองผลลัพธ์ ไม่จำกัดการแนะนำประเทศนี้ รหัสภูมิภาคยอมรับค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส ccTLD ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 แต่มีข้อยกเว้นบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ในขณะที่รหัส ISO 3166-1 คือ "gb" (ทางเทคนิคสำหรับเอนทิตีของ "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
types optional
ประเภท:  Array<string> optional
ประเภทของการคาดการณ์ที่จะแสดง โปรดดูประเภทที่รองรับใน คู่มือนักพัฒนาซอฟต์แวร์ หากไม่ได้ระบุประเภท ระบบจะแสดงผลทุกประเภท

คลาสเติมข้อความอัตโนมัติ

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

วิดเจ็ตที่มีการคาดคะเนสถานที่ตามการป้อนข้อความของผู้ใช้ โดยจะแนบกับองค์ประกอบอินพุตประเภท text และรอฟังการป้อนข้อความในช่องนั้น รายการการคาดคะเนจะแสดงเป็นรายการแบบเลื่อนลงและจะอัปเดตเมื่อมีการป้อนข้อความ

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

เข้าถึงโดยโทรไปที่ const {Autocomplete} = await google.maps.importLibrary("places") ดูไลบรารีใน Maps JavaScript API
Autocomplete
Autocomplete(inputField[, opts])
พารามิเตอร์: 
  • inputField:  HTMLInputElement ช่องข้อความ <input> ที่ควรแนบ Autocomplete
  • opts:  ตัวเลือก AutocompleteOptions optional
สร้างอินสแตนซ์ Autocomplete ใหม่ที่แนบกับช่องข้อความอินพุตที่ระบุด้วยตัวเลือกที่ระบุ
getBounds
getBounds()
พารามิเตอร์: ไม่มี
Return Value:  LatLngBounds|undefined ขอบเขตของการให้น้ำหนัก
แสดงผลขอบเขตที่การคาดการณ์มีความลำเอียง
getFields
getFields()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Array<string>|undefined
แสดงผลฟิลด์ที่จะรวมสำหรับสถานที่ในคำตอบรายละเอียดเมื่อดึงรายละเอียดสำเร็จ ดูรายการฟิลด์ได้ที่ PlaceResult
getPlace
getPlace()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  PlaceResult สถานที่ที่ผู้ใช้เลือก
แสดงรายละเอียดของสถานที่ที่ผู้ใช้เลือก หากดึงรายละเอียดสำเร็จ มิเช่นนั้นจะแสดงออบเจ็กต์สถานที่สตับ โดยตั้งค่าพร็อพเพอร์ตี้ name เป็นค่าปัจจุบันของช่องป้อนข้อมูล
setBounds
setBounds(bounds)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
ตั้งค่าพื้นที่ที่ต้องการเพื่อแสดงผลการค้นหาสถานที่ ผลลัพธ์จะให้ความลำเอียงกับ แต่ไม่จำกัดเพียง พื้นที่นี้
setComponentRestrictions
setComponentRestrictions(restrictions)
พารามิเตอร์: 
  • restrictions:  ComponentRestrictions optional ข้อจำกัดในการใช้งาน
ผลลัพธ์: ไม่มี
ตั้งค่าข้อจำกัดของคอมโพเนนต์ ข้อจำกัดของคอมโพเนนต์ใช้เพื่อจำกัดการคาดการณ์ไว้เฉพาะการคาดคะเนที่อยู่ในคอมโพเนนต์หลักเท่านั้น เช่น ประเทศ
setFields
setFields(fields)
พารามิเตอร์: 
  • fields:  Array<string> optional
ผลลัพธ์: ไม่มี
ตั้งค่าฟิลด์ที่จะรวมสำหรับสถานที่ในคำตอบรายละเอียดเมื่อดึงรายละเอียดสำเร็จ ดูรายการฟิลด์ได้ที่ PlaceResult
setOptions
setOptions(options)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
setTypes
setTypes(types)
พารามิเตอร์: 
  • types:  Array<string> optional ประเภทของการคาดการณ์ที่จะรวม
ผลลัพธ์: ไม่มี
ตั้งค่าประเภทของการคาดการณ์ที่จะแสดง โปรดดูประเภทที่รองรับใน คู่มือนักพัฒนาซอฟต์แวร์ หากไม่ได้ระบุประเภท ระบบจะแสดงผลทุกประเภท
รับค่าเดิม: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเริ่มทำงานเมื่อ PlaceResult พร้อมใช้งานสำหรับสถานที่ที่ผู้ใช้เลือกไว้
หากผู้ใช้ป้อนชื่อสถานที่ที่ตัวควบคุมไม่ได้แนะนำและกดปุ่ม Enter หรือหากส่งคำขอรายละเอียดสถานที่ไม่สำเร็จ PlaceResult จะมีข้อมูลที่ผู้ใช้ป้อนในพร็อพเพอร์ตี้ name โดยไม่มีการกำหนดพร็อพเพอร์ตี้อื่นๆ ไว้

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

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

ตัวเลือกที่ตั้งค่าได้ในออบเจ็กต์ Autocomplete
bounds optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
พื้นที่ที่จะค้นหาสถานที่
componentRestrictions optional
ประเภท:  ComponentRestrictions optional
ข้อจำกัดของคอมโพเนนต์ ข้อจำกัดของคอมโพเนนต์ใช้เพื่อจำกัดการคาดการณ์ไว้เฉพาะการคาดคะเนที่อยู่ในคอมโพเนนต์หลักเท่านั้น เช่น ประเทศ
fields optional
ประเภท:  Array<string> optional
ช่องที่จะรวมสำหรับสถานที่ในการตอบกลับเกี่ยวกับรายละเอียดเมื่อดึงรายละเอียดสำเร็จ ซึ่งจะมีการเรียกเก็บเงิน หากมีการส่ง ['ALL'] เข้ามา ระบบจะส่งคืนช่องที่มีอยู่ทั้งหมดและเรียกเก็บเงินสำหรับฟิลด์ (ไม่แนะนำสำหรับการทำให้ใช้งานได้ในเวอร์ชันที่ใช้งานจริง) ดูรายการฟิลด์ได้ที่ PlaceResult คุณระบุช่องที่ซ้อนกันด้วยเส้นทางแบบจุด (เช่น "geometry.location") ได้ ค่าเริ่มต้นคือ ['ALL']
placeIdOnly optional
ประเภท:  boolean optional
เรียกข้อมูลเฉพาะรหัสสถานที่หรือไม่ PlaceResult ที่สามารถใช้งานได้เมื่อเหตุการณ์place_changed เริ่มทำงานจะมีเฉพาะช่อง "place_id", "ประเภท" และ "ชื่อ" พร้อมทั้ง "place_id", "ประเภท" และคำอธิบายซึ่งแสดงผลโดยบริการเติมข้อความอัตโนมัติ ปิดใช้โดยค่าเริ่มต้น
strictBounds optional
ประเภท:  boolean optional
ค่าบูลีนซึ่งบ่งชี้ว่าวิดเจ็ตการเติมข้อความอัตโนมัติควรแสดงเฉพาะสถานที่ที่อยู่ภายในขอบเขตของวิดเจ็ตเติมข้อความอัตโนมัติในขณะที่ส่งคำค้นหาเท่านั้น การตั้งค่า strictBounds เป็น false (ซึ่งเป็นค่าเริ่มต้น) จะทำให้ผลลัพธ์มีความเอนเอียงต่อ (แต่ไม่จำกัดเพียง) ตำแหน่งที่อยู่ในขอบเขตของ
types optional
ประเภท:  Array<string> optional
ประเภทของการคาดการณ์ที่จะแสดง โปรดดูประเภทที่รองรับใน คู่มือนักพัฒนาซอฟต์แวร์ หากไม่ได้ระบุประเภท ระบบจะแสดงผลทุกประเภท

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

วิดเจ็ตที่คาดคะเนข้อความค้นหาตามการป้อนข้อความของผู้ใช้ โดยจะแนบกับองค์ประกอบอินพุตประเภท text และรอฟังการป้อนข้อความในช่องนั้น รายการการคาดคะเนจะแสดงเป็นรายการแบบเลื่อนลงและจะอัปเดตเมื่อมีการป้อนข้อความ

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

เข้าถึงโดยโทรไปที่ const {SearchBox} = await google.maps.importLibrary("places") ดูไลบรารีใน Maps JavaScript API
SearchBox
SearchBox(inputField[, opts])
พารามิเตอร์: 
สร้างอินสแตนซ์ SearchBox ใหม่ที่แนบกับช่องข้อความอินพุตที่ระบุด้วยตัวเลือกที่ระบุ
getBounds
getBounds()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  LatLngBounds|undefined
แสดงผลขอบเขตที่การคาดคะเนการค้นหามีการให้น้ำหนักพิเศษ
getPlaces
getPlaces()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Array<PlaceResult>|undefined
แสดงผลคำค้นหาที่ผู้ใช้เลือกเพื่อใช้กับเหตุการณ์ places_changed
setBounds
setBounds(bounds)
พารามิเตอร์: 
ผลลัพธ์: ไม่มี
ตั้งค่าภูมิภาคที่จะใช้สำหรับการให้น้ำหนักการคาดการณ์ข้อความค้นหา ผลลัพธ์จะถูกให้น้ำหนักพิเศษกับบริเวณนี้เท่านั้น และไม่ถูกจำกัดขอบเขตไว้โดยสมบูรณ์
รับค่าเดิม: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
อาร์กิวเมนต์: ไม่มี
เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้เลือกคำค้นหา ควรใช้ getPlaces เพื่อรับสถานที่ใหม่ๆ

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

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

ตัวเลือกที่ตั้งค่าได้ในออบเจ็กต์ SearchBox
bounds optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
พื้นที่ที่จะให้น้ำหนักกับการคาดคะเนข้อความค้นหา การคาดการณ์มีความลำเอียงต่อแต่ไม่จำกัดเพียงคำค้นหาที่กำหนดเป้าหมายไปยังขอบเขตเหล่านี้