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) พารามิเตอร์:
ค่าที่ส่งกลับ:
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) พารามิเตอร์:
ค่าที่ส่งกลับ: ไม่มี
ตั้งค่าข้อจํากัดของคอมโพเนนต์ ข้อจํากัดของคอมโพเนนต์ใช้เพื่อจํากัดเฉพาะการคาดการณ์ภายในคอมโพเนนต์ระดับบนสุดเท่านั้น เช่น ประเทศ |
setFields |
setFields(fields) พารามิเตอร์:
ค่าที่ส่งกลับ: ไม่มี
ตั้งค่าฟิลด์ที่จะรวมไว้ใน สถานที่ ในการตอบกลับรายละเอียดเมื่อสามารถดึงรายละเอียดได้สําเร็จ ดูรายการช่องได้ที่ PlaceResult |
setOptions |
setOptions(options) พารามิเตอร์:
ค่าที่ส่งกลับ: ไม่มี
|
setTypes |
setTypes(types) พารามิเตอร์:
ค่าที่ส่งกลับ: ไม่มี
ตั้งค่าประเภทของการคาดการณ์ที่จะส่งคืน โปรดดู คู่มือสําหรับนักพัฒนาซอฟต์แวร์สําหรับประเภทที่รองรับ หากไม่ได้ระบุประเภท ระบบจะส่งคืนค่าทุกประเภท |
รับค่าเดิม:
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'] |
|
ประเภท:
boolean optional เรียกดูเฉพาะรหัสสถานที่หรือไม่ PlaceResult ที่พร้อมใช้งานเมื่อเหตุการณ์ event_changed เริ่มทํางานจะมีเฉพาะช่อง place_id, ประเภท และชื่อ ซึ่งมี Place_id, ประเภท และคําอธิบายที่แสดงโดยบริการเติมข้อความอัตโนมัติ ปิดการใช้งานโดยค่าเริ่มต้น |
strictBounds optional |
ประเภท:
boolean optional ค่าบูลีนที่ระบุว่าวิดเจ็ตเติมข้อความอัตโนมัติควรแสดงผลเฉพาะสถานที่ที่อยู่ภายในขอบเขตของวิดเจ็ตเติมข้อความอัตโนมัติในขณะที่มีการส่งข้อความค้นหา การตั้งค่า strictBounds เป็น false (ซึ่งเป็นค่าเริ่มต้น) จะทําให้การให้น้ําหนักพิเศษกับแต่ไม่จํากัดเฉพาะสถานที่ที่อยู่ภายในขอบเขต |
types optional |
ประเภท:
Array<string> optional ประเภทของการคาดการณ์ที่จะส่งคืน โปรดดู คู่มือสําหรับนักพัฒนาซอฟต์แวร์สําหรับประเภทที่รองรับ หากไม่ได้ระบุประเภท ระบบจะส่งคืนค่าทุกประเภท |
SearchBox
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 พื้นที่ที่จะคาดคะเนการคาดคะเน การคาดคะเนจะมีอคติต่อคําค้นหาที่กําหนดเป้าหมายในขอบเขตเหล่านี้ |