Places Widgets

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

google.maps.places.Autocomplete คลาส

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

คลาสนี้จะขยาย MVCObject

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {Autocomplete} = await google.map.importLibrary("places") โปรดดูไลบรารีใน Maps JavaScript API
Autocomplete
Autocomplete(inputField[, opts])
พารามิเตอร์:
  • inputField: HTMLInputElement ช่องข้อความ <input> ที่ควรแนบ Autocomplete
  • opts:  AutocompleteOptions optional ตัวเลือก
สร้างอินสแตนซ์ใหม่ของ Autocomplete ที่แนบลงในช่องข้อความที่ป้อนที่ระบุด้วยตัวเลือกที่ระบุ
getBounds
getBounds()
พารามิเตอร์: ไม่มี
ค่าที่แสดงผล: LatLngBounds|undefined ขอบเขตการให้น้ําหนัก
แสดงผลขอบเขตที่มีการทํานายการให้น้ําหนักพิเศษ
getFields
getFields()
พารามิเตอร์: ไม่มี
แสดงผลค่า: Array<string>|undefined
แสดงผลช่องที่จะรวมไว้สําหรับสถานที่ในการตอบกลับรายละเอียดเมื่อดึงข้อมูลรายละเอียดเรียบร้อยแล้ว โปรดดูรายการช่องใน PlaceResult
getPlace
getPlace()
พารามิเตอร์: ไม่มี
ค่าคืนสินค้า: PlaceResult สถานที่ที่ผู้ใช้เลือก
แสดงผลรายละเอียดของสถานที่ที่ผู้ใช้เลือก หากรายละเอียดถูกดึงข้อมูลสําเร็จ ไม่เช่นนั้นระบบจะเปลี่ยนออบเจ็กต์ Place Stub ที่มีการตั้งค่าพร็อพเพอร์ตี้ name เป็นค่าปัจจุบันของช่องอินพุต
setBounds
setBounds(bounds)
พารามิเตอร์:
ค่าการแสดงผล: ไม่มี
กําหนดพื้นที่ที่ต้องการเพื่อแสดงผลการค้นหาสถานที่ ผลลัพธ์นี้มีความลําเอียงแต่ไม่จํากัดเฉพาะพื้นที่นี้
setComponentRestrictions
setComponentRestrictions(restrictions)
พารามิเตอร์:
ค่าการแสดงผล: ไม่มี
ตั้งค่าข้อจํากัดของคอมโพเนนต์ ข้อจํากัดของคอมโพเนนต์ใช้เพื่อจํากัดการคาดการณ์ไว้เฉพาะภายในคอมโพเนนต์ระดับบนเท่านั้น เช่น ประเทศ
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 ได้

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
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

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {SearchBox} = await google.map.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 ได้

โหลดโดยใช้พารามิเตอร์ของ URL &libraries=places โปรดดูไลบรารีใน Maps JavaScript API
bounds optional
ประเภท: LatLngBounds|LatLngBoundsLiteral optional
พื้นที่ที่จะระบุการคาดคะเนการค้นหา การคาดการณ์จะส่งผลต่อการให้น้ําหนักพิเศษ ซึ่งรวมถึงแต่ไม่จํากัดเพียงคําค้นหาที่กําหนดขอบเขตเหล่านี้