Places Widgets

PlaceAutocompleteElement คลาส

google.maps.places.PlaceAutocompleteElement ชั้น

การใช้งาน AutocompleteView สําหรับ API ของ Places

คลาสนี้ใช้ 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
รหัสภูมิภาคที่ใช้สําหรับการจัดรูปแบบผลลัพธ์และสําหรับการกรองผลลัพธ์ ไม่จํากัดคําแนะนําเฉพาะในประเทศนี้ รหัสภูมิภาคยอมรับค่าที่เป็นอักขระ 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])
พารามิเตอร์: 
สร้างอินสแตนซ์ใหม่ของ Autocomplete ที่แนบลงในช่องข้อความที่ป้อนซึ่งมีตัวเลือกที่ระบุ
getBounds
getBounds()
พารามิเตอร์: ไม่มี
ค่าที่ส่งกลับ:  LatLngBounds|undefined ขอบเขตการให้น้ําหนัก
แสดงผลขอบเขตที่การให้น้ําหนักผลลัพธ์
getFields
getFields()
พารามิเตอร์: ไม่มี
ค่าที่ส่งกลับ:  Array<string>|undefined
ส่งคืนฟิลด์ที่จะรวมไว้ใน สถานที่ ในการตอบกลับรายละเอียดเมื่อเรียกคืนรายละเอียดเรียบร้อยแล้ว ดูรายการช่องได้ที่ PlaceResult
getPlace
getPlace()
พารามิเตอร์: ไม่มี
ระยะเวลาที่ส่งกลับ:  PlaceResult สถานที่ที่ผู้ใช้เลือก
แสดงรายละเอียดของสถ านที่ที่ผู้ใช้เลือก ถ้ามีการเรียกข้อมูลรายละเอียดเรียบร้อยแล้ว มิเช่นนั้น จะแสดงผลออบเจ็กต์ Place stub ซึ่งตั้งค่าพร็อพเพอร์ตี้ 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 ที่พร้อมใช้งานเมื่อเหตุการณ์ event_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
พื้นที่ที่จะคาดคะเนการคาดคะเน การคาดคะเนจะมีอคติต่อคําค้นหาที่กําหนดเป้าหมายในขอบเขตเหล่านี้