Places Widgets

คลาส PlaceAutocompleteElement

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

PlaceAutocompleteElement เป็นคลาสย่อย HTMLElement ซึ่งมีคอมโพเนนต์ UI สำหรับ Places Autocomplete API

PlaceAutocompleteElement จะใช้ AutocompleteSessionToken ภายในโดยอัตโนมัติเพื่อจัดกลุ่มระยะการค้นหาและการเลือกของการค้นหาด้วยการเติมข้อความอัตโนมัติของผู้ใช้

การเรียกใช้ Place.fetchFields ครั้งแรกใน Place ที่ PlacePrediction.toPlace แสดงผลจะรวมโทเค็นของเซสชันที่ใช้ดึงข้อมูล PlacePrediction โดยอัตโนมัติ

ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการทำงานของเซสชันได้ที่ https://developers.google.com/maps/documentation/places/web-service/place-session-tokens

องค์ประกอบที่กำหนดเอง:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-place-autocomplete>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceAutocompleteElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceAutocompleteElement
PlaceAutocompleteElement(options)
พารามิเตอร์ 
includedPrimaryTypes
ประเภท:  Array<string> optional
ประเภทสถานที่หลักที่รวมอยู่ (เช่น "ร้านอาหาร" หรือ "ปั๊มน้ำมัน")

ระบบจะแสดงผลสถานที่ก็ต่อเมื่อประเภทหลักของสถานที่นั้นรวมอยู่ในรายการนี้ โดยระบุได้สูงสุด 5 ค่า หากไม่ได้ระบุประเภท ระบบจะแสดงผลสถานที่ทุกประเภท
แอตทริบิวต์ HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
ประเภท:  Array<string> optional
รวมเฉพาะผลการค้นหาในภูมิภาคที่ระบุ ซึ่งระบุเป็นรหัสภูมิภาค CLDR แบบ 2 อักขระได้สูงสุด 15 รหัส ชุดที่ว่างเปล่าจะไม่จำกัดผลลัพธ์ หากตั้งค่าทั้ง locationRestriction และ includedRegionCodes ผลลัพธ์จะอยู่ในพื้นที่ที่ทับซ้อนกัน
แอตทริบิวต์ HTML:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
ประเภท:  LocationBias optional
ขอบเขตหรือคำแนะนำแบบคร่าวๆ ที่จะใช้เมื่อค้นหาสถานที่
locationRestriction
ประเภท:  LocationRestriction optional
ขอบเขตเพื่อจำกัดผลการค้นหา
name
ประเภท:  string optional
ชื่อที่จะใช้สำหรับองค์ประกอบอินพุต ดูรายละเอียดได้ที่ https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name เป็นไปตามลักษณะการทำงานเดียวกันกับแอตทริบิวต์ชื่อสำหรับอินพุต โปรดทราบว่าชื่อนี้จะใช้เมื่อส่งแบบฟอร์ม ดูรายละเอียดได้ที่ https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form
แอตทริบิวต์ HTML:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
ต้นทางที่จะใช้คำนวณระยะทาง หากไม่ได้ระบุ ระบบจะไม่คำนวณระยะทาง ระบบจะไม่ใช้ระดับความสูงในการคำนวณ หากระบุไว้
แอตทริบิวต์ HTML:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
placeholder
ประเภท:  string
ข้อความตัวยึดตำแหน่งที่จะแสดงในองค์ประกอบอินพุต
requestedLanguage
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ (หากเป็นไปได้) ผลการค้นหาในภาษาที่เลือกอาจได้รับการจัดอันดับที่สูงขึ้น แต่คำแนะนำไม่ได้จำกัดเฉพาะภาษานี้ ดูรายการภาษาที่รองรับ
แอตทริบิวต์ HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
ประเภท:  string optional
รหัสภูมิภาคที่ใช้สำหรับการจัดรูปแบบผลลัพธ์และการกรองผลลัพธ์ แต่ไม่ได้จำกัดคำแนะนำไว้เฉพาะในประเทศนี้ รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับหน่วยงาน "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
แอตทริบิวต์ HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem
ประเภท:  UnitSystem optional
ระบบหน่วยที่ใช้แสดงระยะทาง หากไม่ได้ระบุ ระบบหน่วยจะกำหนดโดย requestedRegion
แอตทริบิวต์ HTML:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
value
ประเภท:  string
ค่าขององค์ประกอบอินพุต
prediction-item-icon
ช่องนี้ยอมรับองค์ประกอบ <template> เพียงรายการเดียวเพื่อแสดงผลเป็นไอคอนที่แสดงข้างรายการการคาดคะเน
input
องค์ประกอบอินพุตสำหรับองค์ประกอบการเติมข้อความอัตโนมัติ
prediction-item
รายการในเมนูแบบเลื่อนลงของการคาดคะเนที่แสดงการคาดคะเนเดียว
prediction-item-icon
ไอคอนที่แสดงทางด้านซ้ายของแต่ละรายการในรายการการคาดคะเน
prediction-item-main-text
ส่วนของรายการการคาดคะเนซึ่งเป็นข้อความหลักของการคาดคะเน สำหรับสถานที่ตั้งทางภูมิศาสตร์ ข้อมูลนี้จะประกอบด้วยชื่อสถานที่ เช่น "ซิดนีย์" หรือชื่อถนนและหมายเลข เช่น "10 King Street" โดยค่าเริ่มต้น prediction-item-main-text จะเป็นสีดำ หากมีข้อความเพิ่มเติมใน prediction-item ข้อความนั้นจะอยู่นอก prediction-item-main-text และรับการจัดรูปแบบจาก prediction-item โดยจะมีสีเทาเป็นค่าเริ่มต้น โดยปกติแล้ว ข้อความเพิ่มเติมจะเป็นที่อยู่
prediction-item-match
ส่วนของการคาดคะเนที่แสดงผลซึ่งตรงกับข้อมูลที่ผู้ใช้ป้อน โดยค่าเริ่มต้น ระบบจะไฮไลต์ข้อความที่ตรงกันนี้เป็นการทำข้อความเป็นตัวหนา โปรดทราบว่าข้อความที่ตรงกันอาจอยู่ตรงไหนก็ได้ภายใน prediction-item โดยไม่จำเป็นต้องเป็นส่วนหนึ่งของ prediction-item-main-text
prediction-item-selected
รายการเมื่อผู้ใช้ไปยังส่วนต่างๆ โดยใช้แป้นพิมพ์ หมายเหตุ: รายการที่เลือกจะได้รับผลกระทบจากทั้งรูปแบบส่วนนี้และรูปแบบส่วนรายการการคาดคะเน
prediction-list
องค์ประกอบภาพที่มีรายการการคาดคะเนที่แสดงผลโดยบริการ Place Autocomplete รายการนี้จะปรากฏเป็นรายการแบบเลื่อนลงใต้ PlaceAutocompleteElement
background-color
ลบล้างสีพื้นหลังขององค์ประกอบ
border
ลบล้างเส้นขอบขององค์ประกอบ
border-radius
ลบล้างรัศมีเส้นขอบขององค์ประกอบ
color
ลบล้างแบบอักษรขององค์ประกอบ
color-scheme
ระบุรูปแบบสีที่แสดงผลองค์ประกอบนี้ได้ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ color-scheme ค่าเริ่มต้นคือ color-scheme: light dark
font
ลบล้างแบบอักษรขององค์ประกอบ
font-family
ลบล้างแบบอักษรขององค์ประกอบ
font-size
ลบล้างแบบอักษรขององค์ประกอบ
font-style
ลบล้างแบบอักษรขององค์ประกอบ
font-weight
ลบล้างแบบอักษรขององค์ประกอบ
line-height
ลบล้างแบบอักษรขององค์ประกอบ
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener
gmp-error
function(errorEvent)
อาร์กิวเมนต์ 
เหตุการณ์นี้จะเริ่มทำงานเมื่อคำขอไปยังแบ็กเอนด์ถูกปฏิเสธ (เช่น คีย์ API ไม่ถูกต้อง) เหตุการณ์นี้ไม่เกิดการส่งต่อเหตุการณ์
gmp-select
function(placePredictionSelectEvent)
อาร์กิวเมนต์ 
เหตุการณ์นี้จะเริ่มทำงานเมื่อผู้ใช้เลือกการคาดคะเนสถานที่ มีออบเจ็กต์ PlacePrediction ซึ่งแปลงเป็นออบเจ็กต์ Place ได้

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

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

ตัวเลือกสำหรับการสร้าง PlaceAutocompleteElement ดูคำอธิบายของพร็อพเพอร์ตี้แต่ละรายการได้ที่พร็อพเพอร์ตี้ที่มีชื่อเดียวกันในคลาส PlaceAutocompleteElement

includedPrimaryTypes optional
ประเภท:  Array<string> optional
includedRegionCodes optional
ประเภท:  Array<string> optional
locationBias optional
ประเภท:  LocationBias optional
locationRestriction optional
ประเภท:  LocationRestriction optional
name optional
ประเภท:  string optional
origin optional
requestedLanguage optional
ประเภท:  string optional
requestedRegion optional
ประเภท:  string optional
unitSystem optional
ประเภท:  UnitSystem optional
value optional
ประเภท:  string optional
ค่าขององค์ประกอบอินพุต

คลาส PlacePredictionSelectEvent

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

ระบบจะสร้างเหตุการณ์นี้หลังจากที่ผู้ใช้เลือกรายการการคาดคะเนด้วย PlaceAutocompleteElement เข้าถึงรายการที่เลือกด้วย event.placePrediction

แปลง placePrediction เป็น Place โดยเรียกใช้ PlacePrediction.toPlace

คลาสนี้ขยาย Event

เข้าถึงโดยโทรไปที่ const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

placePrediction
ประเภท:  PlacePrediction
แปลงเป็น Place โดยเรียกใช้ PlacePrediction.toPlace

คลาส BasicPlaceAutocompleteElement

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

BasicPlaceAutocompleteElement เป็นคลาสย่อย HTMLElement ซึ่งมีคอมโพเนนต์ UI สำหรับ Places Autocomplete API

องค์ประกอบที่กำหนดเอง:
<gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-basic-place-autocomplete>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ BasicPlaceAutocompleteElementOptions

เข้าถึงโดยโทรไปที่ const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

BasicPlaceAutocompleteElement
BasicPlaceAutocompleteElement(options)
พารามิเตอร์ 
includedPrimaryTypes
ประเภท:  Array<string> optional
ประเภทสถานที่หลักที่รวมอยู่ (เช่น "ร้านอาหาร" หรือ "ปั๊มน้ำมัน")

ระบบจะแสดงผลสถานที่ก็ต่อเมื่อประเภทหลักของสถานที่นั้นรวมอยู่ในรายการนี้ โดยระบุได้สูงสุด 5 ค่า หากไม่ได้ระบุประเภท ระบบจะแสดงผลสถานที่ทุกประเภท
แอตทริบิวต์ HTML:
  • <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
ประเภท:  Array<string> optional
รวมเฉพาะผลการค้นหาในภูมิภาคที่ระบุ ซึ่งระบุเป็นรหัสภูมิภาค CLDR แบบ 2 อักขระได้สูงสุด 15 รหัส ชุดที่ว่างเปล่าจะไม่จำกัดผลลัพธ์ หากตั้งค่าทั้ง locationRestriction และ includedRegionCodes ผลลัพธ์จะอยู่ในพื้นที่ที่ทับซ้อนกัน
แอตทริบิวต์ HTML:
  • <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-place-autocomplete>
locationBias
ประเภท:  LocationBias optional
ขอบเขตหรือคำแนะนำแบบคร่าวๆ ที่จะใช้เมื่อค้นหาสถานที่
locationRestriction
ประเภท:  LocationRestriction optional
ขอบเขตเพื่อจำกัดผลการค้นหา
name
ประเภท:  string optional
ชื่อที่จะใช้สำหรับองค์ประกอบอินพุต ดูรายละเอียดได้ที่ https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name เป็นไปตามลักษณะการทำงานเดียวกันกับแอตทริบิวต์ชื่อสำหรับอินพุต โปรดทราบว่าชื่อนี้จะใช้เมื่อส่งแบบฟอร์ม ดูรายละเอียดได้ที่ https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form
แอตทริบิวต์ HTML:
  • <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
ต้นทางที่จะใช้คำนวณระยะทาง หากไม่ได้ระบุ ระบบจะไม่คำนวณระยะทาง ระบบจะไม่ใช้ระดับความสูงในการคำนวณ หากระบุไว้
แอตทริบิวต์ HTML:
  • <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage
ประเภท:  string optional
ตัวระบุภาษาสำหรับภาษาที่ควรแสดงผลลัพธ์ (หากเป็นไปได้) ผลการค้นหาในภาษาที่เลือกอาจได้รับการจัดอันดับที่สูงขึ้น แต่คำแนะนำไม่ได้จำกัดเฉพาะภาษานี้ ดูรายการภาษาที่รองรับ
แอตทริบิวต์ HTML:
  • <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion
ประเภท:  string optional
รหัสภูมิภาคที่ใช้สำหรับการจัดรูปแบบผลลัพธ์และการกรองผลลัพธ์ แต่ไม่ได้จำกัดคำแนะนำไว้เฉพาะในประเทศนี้ รหัสภูมิภาคยอมรับค่า ccTLD ("โดเมนระดับบนสุด") แบบ 2 อักขระ รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับหน่วยงาน "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
แอตทริบิวต์ HTML:
  • <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem
ประเภท:  UnitSystem optional
ระบบหน่วยที่ใช้แสดงระยะทาง หากไม่ได้ระบุ ระบบหน่วยจะกำหนดโดย requestedRegion
แอตทริบิวต์ HTML:
  • <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>
prediction-item-icon
ช่องนี้ยอมรับองค์ประกอบ <template> เพียงรายการเดียวเพื่อแสดงผลเป็นไอคอนที่แสดงข้างรายการการคาดคะเน
input
องค์ประกอบอินพุตสำหรับองค์ประกอบการเติมข้อความอัตโนมัติ
prediction-item
รายการในเมนูแบบเลื่อนลงของการคาดคะเนที่แสดงการคาดคะเนเดียว
prediction-item-icon
ไอคอนที่แสดงทางด้านซ้ายของแต่ละรายการในรายการการคาดคะเน
prediction-item-main-text
ส่วนของรายการการคาดคะเนซึ่งเป็นข้อความหลักของการคาดคะเน สำหรับสถานที่ตั้งทางภูมิศาสตร์ ข้อมูลนี้จะประกอบด้วยชื่อสถานที่ เช่น "ซิดนีย์" หรือชื่อถนนและหมายเลข เช่น "10 King Street" โดยค่าเริ่มต้น prediction-item-main-text จะเป็นสีดำ หากมีข้อความเพิ่มเติมใน prediction-item ข้อความนั้นจะอยู่นอก prediction-item-main-text และรับการจัดรูปแบบจาก prediction-item โดยจะมีสีเทาเป็นค่าเริ่มต้น โดยปกติแล้ว ข้อความเพิ่มเติมจะเป็นที่อยู่
prediction-item-match
ส่วนของการคาดคะเนที่แสดงผลซึ่งตรงกับข้อมูลที่ผู้ใช้ป้อน โดยค่าเริ่มต้น ระบบจะไฮไลต์ข้อความที่ตรงกันนี้เป็นการทำข้อความเป็นตัวหนา โปรดทราบว่าข้อความที่ตรงกันอาจอยู่ตรงไหนก็ได้ภายใน prediction-item โดยไม่จำเป็นต้องเป็นส่วนหนึ่งของ prediction-item-main-text
prediction-item-selected
รายการเมื่อผู้ใช้ไปยังส่วนต่างๆ โดยใช้แป้นพิมพ์ หมายเหตุ: รายการที่เลือกจะได้รับผลกระทบจากทั้งรูปแบบส่วนนี้และรูปแบบส่วนรายการการคาดคะเน
prediction-list
องค์ประกอบภาพที่มีรายการการคาดคะเนที่แสดงผลโดยบริการ Place Autocomplete รายการนี้จะปรากฏเป็นรายการแบบเลื่อนลงใต้ PlaceAutocompleteElement
background-color
ลบล้างสีพื้นหลังขององค์ประกอบ
border
ลบล้างเส้นขอบขององค์ประกอบ
border-radius
ลบล้างรัศมีเส้นขอบขององค์ประกอบ
color
ลบล้างแบบอักษรขององค์ประกอบ
color-scheme
ระบุรูปแบบสีที่แสดงผลองค์ประกอบนี้ได้ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ color-scheme ค่าเริ่มต้นคือ color-scheme: light dark
font
ลบล้างแบบอักษรขององค์ประกอบ
font-family
ลบล้างแบบอักษรขององค์ประกอบ
font-size
ลบล้างแบบอักษรขององค์ประกอบ
font-style
ลบล้างแบบอักษรขององค์ประกอบ
font-weight
ลบล้างแบบอักษรขององค์ประกอบ
line-height
ลบล้างแบบอักษรขององค์ประกอบ
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener
gmp-error
function(errorEvent)
อาร์กิวเมนต์ 
เหตุการณ์นี้จะเริ่มทำงานเมื่อคำขอไปยังแบ็กเอนด์ถูกปฏิเสธ (เช่น คีย์ API ไม่ถูกต้อง) เหตุการณ์นี้ไม่เกิดการส่งต่อเหตุการณ์
gmp-select
function(placeSelectEvent)
อาร์กิวเมนต์ 
เหตุการณ์นี้จะเริ่มทำงานเมื่อผู้ใช้เลือกการคาดคะเนสถานที่ มีออบเจ็กต์ Place

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

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

ตัวเลือกสำหรับการสร้าง BasicPlaceAutocompleteElement

includedPrimaryTypes optional
ประเภท:  Array<string> optional
includedRegionCodes optional
ประเภท:  Array<string> optional
locationBias optional
ประเภท:  LocationBias optional
locationRestriction optional
ประเภท:  LocationRestriction optional
name optional
ประเภท:  string optional
origin optional
requestedLanguage optional
ประเภท:  string optional
requestedRegion optional
ประเภท:  string optional
unitSystem optional
ประเภท:  UnitSystem optional

คลาส PlaceDetailsElement

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

แสดงรายละเอียดของสถานที่ในเลย์เอาต์แบบเต็ม เพิ่ม PlaceDetailsPlaceRequestElement หรือ PlaceDetailsLocationRequestElement เพื่อระบุตำแหน่งที่จะแสดงผล เพิ่ม PlaceContentConfigElement, PlaceStandardContentElement หรือ PlaceAllContentElement เพื่อระบุเนื้อหาที่จะแสดงผล

ตัวอย่างเช่น

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details>

หากต้องการใช้องค์ประกอบนี้ ให้เปิดใช้ Places UI Kit API สำหรับโปรเจ็กต์ในคอนโซล Google Cloud

องค์ประกอบที่กำหนดเอง:
<gmp-place-details></gmp-place-details>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceDetailsElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceDetailsElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceDetailsElement
PlaceDetailsElement([options])
พารามิเตอร์ 
place
ประเภท:  Place optional
อ่านอย่างเดียว ออบเจ็กต์สถานที่ที่มีรหัส ตำแหน่ง และวิวพอร์ตของสถานที่ที่แสดงผลอยู่ในปัจจุบัน
--gmp-button-border-color
สีเส้นขอบของปุ่ม "เปิดใน Maps"
--gmp-button-border-radius
รัศมีเส้นขอบของปุ่ม "เปิดใน Maps"
--gmp-button-border-width
ความกว้างของขอบปุ่ม "เปิดใน Maps"
--gmp-collage-border-radius-outer
รัศมีเส้นขอบของมุมด้านนอกของภาพคอลลาจสื่อ
--gmp-dialog-border-radius
รัศมีเส้นขอบของกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-color-disabled-surface
สีพื้นผิวที่ต้องการสื่อถึงสถานะปิดใช้หรือไม่แสดงตน ใช้สำหรับดาวรีวิวที่ว่างเปล่า
--gmp-mat-color-info
สีขององค์ประกอบ UI ที่มีอารมณ์ความรู้สึกเชิงข้อมูล ใช้สำหรับไอคอนรถเข็น
--gmp-mat-color-negative
สีขององค์ประกอบ UI ที่มีความรู้สึกเชิงลบ ใช้สำหรับข้อความ "ปิด" ในสถานะเปิดอยู่ตอนนี้
--gmp-mat-color-neutral-container
สีคอนเทนเนอร์สำหรับองค์ประกอบ UI ที่เติมสีแบบเรียบๆ ใช้สำหรับตัวยึดตำแหน่งรูปภาพและป้ายวันที่เผยแพร่รีวิว
--gmp-mat-color-on-neutral-container
สีของข้อความและไอคอนที่ตัดกับสีคอนเทนเนอร์ที่เป็นกลาง ใช้สำหรับป้ายวันที่เผยแพร่รีวิวและป้ายความพร้อมให้บริการที่ชาร์จ EV เมื่อไม่พร้อมให้บริการ
--gmp-mat-color-on-positive-container
สีของข้อความและไอคอนที่ตัดกับสีคอนเทนเนอร์เชิงบวก ใช้สำหรับป้ายความพร้อมให้บริการของที่ชาร์จ EV (หากมี)
--gmp-mat-color-on-secondary-container
สีของข้อความและไอคอนที่ตัดกับสีคอนเทนเนอร์รอง ใช้สำหรับข้อความและไอคอนบนปุ่ม "เปิดใน Maps"
--gmp-mat-color-on-surface
สีสำหรับข้อความและไอคอนที่ตัดกับสีพื้นผิว ใช้สำหรับข้อความปกติ
--gmp-mat-color-on-surface-variant
สีที่เน้นน้อยลงสำหรับข้อความและไอคอนเมื่อเทียบกับสีพื้นผิว ใช้สำหรับข้อความที่เน้นน้อยกว่า
--gmp-mat-color-outline-decorative
สีขอบขององค์ประกอบที่ไม่ใช่แบบอินเทอร์แอกทีฟ ใช้สำหรับเส้นขอบขององค์ประกอบ
--gmp-mat-color-positive
สีขององค์ประกอบ UI ที่มีความรู้สึกเชิงบวก ใช้สำหรับข้อความ "เปิด" ในสถานะเปิดอยู่
--gmp-mat-color-positive-container
สีคอนเทนเนอร์สำหรับองค์ประกอบ UI ที่สื่อถึงความรู้สึกเชิงบวก ใช้สำหรับป้ายความพร้อมให้บริการของที่ชาร์จ EV (หากมี)
--gmp-mat-color-primary
สีของข้อความและไอคอนแบบอินเทอร์แอกทีฟตัดกับสีพื้นผิว ใช้สำหรับจำนวนรีวิว ลิงก์ในกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps, ลิงก์เว็บไซต์, ไอคอนในแท็บภาพรวม และ (สีข้อความ/โฟกัส/วางเมาส์เหนือ) ในชื่อแถบแท็บ
--gmp-mat-color-secondary-container
สีเติมที่โดดเด่นน้อยกว่าเมื่อเทียบกับพื้นผิว สำหรับคอมโพเนนต์ที่ด้อยกว่า เช่น ปุ่มโทนสี ใช้สำหรับพื้นหลังของปุ่ม "เปิดใน Maps"
--gmp-mat-color-surface
สีสำหรับพื้นหลัง ใช้สำหรับพื้นหลังขององค์ประกอบและกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-font-body-medium
ใช้สำหรับที่อยู่สถานที่ คะแนน ประเภท ราคา สถานะเปิดอยู่ เวลาทำการ รีวิว หมายเลขโทรศัพท์ เว็บไซต์ Plus Code ฟีเจอร์ยอดนิยม และเนื้อหาในกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-font-body-small
ใช้สำหรับข้อความเนื้อหาในรายการฟีเจอร์ในแท็บ "เกี่ยวกับ"
--gmp-mat-font-display-small
ใช้สำหรับชื่อสถานที่และข้อความสำหรับส่วนหัวของแต่ละฟีเจอร์ในแท็บ "เกี่ยวกับ"
--gmp-mat-font-family
ชุดแบบอักษรพื้นฐานที่ใช้สำหรับข้อความทั้งหมด
--gmp-mat-font-headline-medium
ใช้สำหรับข้อความส่วนหัวในกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-font-label-large
ใช้สำหรับชื่อแท็บ, ปุ่ม "เปิดใน Maps", ข้อความแสดงแหล่งที่มาของผู้รีวิวในแกลเลอรีรูปภาพ, ข้อความแสดงแหล่งที่มาของผู้รีวิวในส่วนรีวิว และลิงก์ในกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-font-label-medium
ใช้สำหรับป้ายจำนวนรูปภาพและป้ายวันที่เผยแพร่รีวิว
--gmp-mat-font-title-small
ใช้สำหรับชื่อของแต่ละส่วนในแท็บ "เกี่ยวกับ"
--gmp-mat-spacing-extra-large
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-extra-small
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-large
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-medium
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-small
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-two-extra-large
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-star-rating-color
สีของดาวที่เติมในคะแนน
background-color
ลบล้างสีพื้นหลังขององค์ประกอบ
border
ลบล้างเส้นขอบขององค์ประกอบ
border-radius
ลบล้างรัศมีเส้นขอบขององค์ประกอบ
color-scheme
ระบุรูปแบบสีที่แสดงผลองค์ประกอบนี้ได้ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ color-scheme ค่าเริ่มต้นคือ color-scheme: light dark
font-size
ปรับขนาดข้อความและไอคอนทั้งหมดในองค์ประกอบ ซึ่งกำหนดไว้ภายในเป็น em ค่าเริ่มต้นคือ 16px
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener
gmp-error
function(event)
อาร์กิวเมนต์ 
เหตุการณ์นี้จะเริ่มทำงานเมื่อคำขอไปยังแบ็กเอนด์ถูกปฏิเสธ (เช่น คีย์ API ไม่ถูกต้อง) เหตุการณ์นี้ไม่เกิดการส่งต่อเหตุการณ์
gmp-load
function(event)
อาร์กิวเมนต์ 
ระบบจะเริ่มเหตุการณ์นี้เมื่อองค์ประกอบโหลดและแสดงผลเนื้อหา เหตุการณ์นี้ไม่เกิดการส่งต่อเหตุการณ์

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

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

ตัวเลือกสำหรับ PlaceDetailsElement

คลาส PlaceDetailsCompactElement

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

แสดงรายละเอียดของสถานที่ในเลย์เอาต์ขนาดกะทัดรัด เพิ่ม PlaceDetailsPlaceRequestElement หรือ PlaceDetailsLocationRequestElement เพื่อระบุตำแหน่งที่จะแสดงผล เพิ่ม PlaceContentConfigElement, PlaceStandardContentElement หรือ PlaceAllContentElement เพื่อระบุเนื้อหาที่จะแสดงผล

ตัวอย่างเช่น

 <gmp-place-details-compact>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details-compact>

หากต้องการใช้องค์ประกอบนี้ ให้เปิดใช้ Places UI Kit API สำหรับโปรเจ็กต์ในคอนโซล Google Cloud

องค์ประกอบที่กำหนดเอง:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceDetailsCompactElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
พารามิเตอร์ 
orientation
ประเภท:  PlaceDetailsOrientation optional
ค่าเริ่มต้น: PlaceDetailsOrientation.VERTICAL
ตัวแปรการวางแนว (แนวตั้งหรือแนวนอน) ขององค์ประกอบ
แอตทริบิวต์ HTML:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
ประเภท:  Place optional
อ่านอย่างเดียว ออบเจ็กต์สถานที่ที่มีรหัส ตำแหน่ง และวิวพอร์ตของสถานที่ที่แสดงผลอยู่ในปัจจุบัน
truncationPreferred
ประเภท:  boolean
ค่าเริ่มต้น: false
หากเป็นจริง ระบบจะตัดชื่อและที่อยู่ของสถานที่ให้พอดีกับบรรทัดเดียวแทนที่จะตัดขึ้นบรรทัดใหม่
แอตทริบิวต์ HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-button-border-color
สีเส้นขอบของปุ่ม "เปิดใน Maps"
--gmp-button-border-radius
รัศมีเส้นขอบของปุ่ม "เปิดใน Maps"
--gmp-button-border-width
ความกว้างของขอบปุ่ม "เปิดใน Maps"
--gmp-dialog-border-radius
รัศมีเส้นขอบของกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-color-info
สีขององค์ประกอบ UI ที่มีอารมณ์ความรู้สึกเชิงข้อมูล ใช้สำหรับไอคอนรถเข็น
--gmp-mat-color-negative
สีขององค์ประกอบ UI ที่มีความรู้สึกเชิงลบ ใช้สำหรับข้อความ "ปิด" ในสถานะเปิดอยู่ตอนนี้
--gmp-mat-color-neutral-container
สีคอนเทนเนอร์สำหรับองค์ประกอบ UI ที่เติมสีแบบเรียบๆ ใช้สำหรับตัวยึดตำแหน่งรูปภาพ
--gmp-mat-color-on-secondary-container
สีของข้อความและไอคอนที่ตัดกับสีคอนเทนเนอร์รอง ใช้สำหรับข้อความและไอคอนบนปุ่ม "เปิดใน Maps"
--gmp-mat-color-on-surface
สีสำหรับข้อความและไอคอนที่ตัดกับสีพื้นผิว ใช้สำหรับข้อความปกติ
--gmp-mat-color-on-surface-variant
สีที่เน้นน้อยลงสำหรับข้อความและไอคอนเมื่อเทียบกับสีพื้นผิว ใช้สำหรับข้อความที่เน้นน้อยกว่า
--gmp-mat-color-outline-decorative
สีขอบขององค์ประกอบที่ไม่ใช่แบบอินเทอร์แอกทีฟ ใช้สำหรับเส้นขอบขององค์ประกอบ
--gmp-mat-color-positive
สีขององค์ประกอบ UI ที่มีความรู้สึกเชิงบวก ใช้สำหรับข้อความ "เปิด" ในสถานะเปิดอยู่
--gmp-mat-color-primary
สีของข้อความและไอคอนแบบอินเทอร์แอกทีฟตัดกับสีพื้นผิว ใช้สำหรับจำนวนรีวิว รวมถึงลิงก์ในกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-color-secondary-container
สีเติมที่โดดเด่นน้อยกว่าเมื่อเทียบกับพื้นผิว สำหรับคอมโพเนนต์ที่ด้อยกว่า เช่น ปุ่มโทนสี ใช้สำหรับพื้นหลังของปุ่ม "เปิดใน Maps"
--gmp-mat-color-surface
สีสำหรับพื้นหลัง ใช้สำหรับพื้นหลังขององค์ประกอบและกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-font-body-medium
ใช้สำหรับข้อความเนื้อหาในกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-font-body-small
ใช้สำหรับที่อยู่ คะแนน ประเภท ราคา และสถานะเปิดอยู่ของสถานที่
--gmp-mat-font-family
ชุดแบบอักษรพื้นฐานที่ใช้สำหรับข้อความทั้งหมด
--gmp-mat-font-headline-medium
ใช้สำหรับข้อความส่วนหัวในกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-font-label-large
ใช้สำหรับปุ่ม "เปิดใน Maps" รวมถึงลิงก์ในกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps และข้อความแสดงแหล่งที่มาของผู้ตรวจสอบในแกลเลอรีรูปภาพ
--gmp-mat-font-label-medium
ใช้สำหรับป้ายจำนวนรูปภาพ
--gmp-mat-font-title-small
ใช้สำหรับชื่อสถานที่
--gmp-mat-spacing-extra-small
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-large
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-medium
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-small
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-star-rating-color
สีของดาวที่เติมในคะแนน
--gmp-thumbnail-border-radius
รัศมีเส้นขอบของภาพขนาดย่อของสถานที่
background-color
ลบล้างสีพื้นหลังขององค์ประกอบ
border
ลบล้างเส้นขอบขององค์ประกอบ
border-radius
ลบล้างรัศมีเส้นขอบขององค์ประกอบ
color-scheme
ระบุรูปแบบสีที่แสดงผลองค์ประกอบนี้ได้ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ color-scheme ค่าเริ่มต้นคือ color-scheme: light dark
font-size
ปรับขนาดข้อความและไอคอนทั้งหมดในองค์ประกอบ ซึ่งกำหนดไว้ภายในเป็น em ค่าเริ่มต้นคือ 16px
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener
gmp-error
function(event)
อาร์กิวเมนต์ 
เหตุการณ์นี้จะเริ่มทำงานเมื่อคำขอไปยังแบ็กเอนด์ถูกปฏิเสธ (เช่น คีย์ API ไม่ถูกต้อง) เหตุการณ์นี้ไม่เกิดการส่งต่อเหตุการณ์
gmp-load
function(event)
อาร์กิวเมนต์ 
ระบบจะเริ่มเหตุการณ์นี้เมื่อองค์ประกอบโหลดและแสดงผลเนื้อหา เหตุการณ์นี้ไม่เกิดการส่งต่อเหตุการณ์

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

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

ตัวเลือกสำหรับ PlaceDetailsCompactElement

orientation optional
ประเภท:  PlaceDetailsOrientation optional
truncationPreferred optional
ประเภท:  boolean optional

ค่าคงที่ PlaceDetailsOrientation

google.maps.places.PlaceDetailsOrientation ค่าคงที่

ตัวแปรการวางแนวสำหรับ PlaceDetailsCompactElement

เข้าถึงโดยโทรไปที่ const {PlaceDetailsOrientation} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

HORIZONTAL การวางแนวนอน
VERTICAL การวางแนวตั้ง

คลาส PlaceDetailsPlaceRequestElement

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

กำหนดค่า PlaceDetailsCompactElement หรือ PlaceDetailsElement เพื่อโหลดข้อมูลตามออบเจ็กต์สถานที่ รหัส หรือชื่อทรัพยากร เพิ่มองค์ประกอบนี้เป็นองค์ประกอบย่อยของ PlaceDetailsCompactElement หรือ PlaceDetailsElement เพื่อโหลดข้อมูลสำหรับสถานที่ที่ระบุ เช่น

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
</gmp-place-details>

องค์ประกอบที่กำหนดเอง:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceDetailsPlaceRequestElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
พารามิเตอร์ 
place
ประเภท:  Place optional
ค่าเริ่มต้น: null
ออบเจ็กต์ รหัส หรือชื่อทรัพยากรของสถานที่ที่จะแสดงรายละเอียดในองค์ประกอบรายละเอียดสถานที่แบบกะทัดรัด พร็อพเพอร์ตี้นี้จะแสดงแอตทริบิวต์เป็นชื่อทรัพยากร
แอตทริบิวต์ HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

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

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

ตัวเลือกสำหรับ PlaceDetailsPlaceRequestElement

place optional
ประเภท:  Place|string optional

คลาส PlaceDetailsLocationRequestElement

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

กำหนดค่า PlaceDetailsCompactElement หรือ PlaceDetailsElement เพื่อโหลดข้อมูลตามตำแหน่ง เพิ่มองค์ประกอบนี้เป็นองค์ประกอบย่อยของ PlaceDetailsCompactElement หรือ PlaceDetailsElement เพื่อโหลดข้อมูลสำหรับตำแหน่งที่ระบุ เช่น

 <gmp-place-details>
  <gmp-place-details-location-request
    location="37.6207665,-122.4284806"
  ></gmp-place-details-location-request>
</gmp-place-details>

องค์ประกอบที่กำหนดเอง:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceDetailsLocationRequestElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
พารามิเตอร์ 
location
ค่าเริ่มต้น: null
ตำแหน่งที่จะแสดงรายละเอียดในองค์ประกอบรายละเอียดสถานที่ ปรับให้เป็น LatLngAltitude
แอตทริบิวต์ HTML:
  • <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

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

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

ตัวเลือกสำหรับ PlaceDetailsLocationRequestElement

location optional
สถานที่ตั้งที่จะแสดงสถานที่

คลาส PlaceSearchElement

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

แสดงผลการค้นหาสถานที่ในรายการ เพิ่ม PlaceTextSearchRequestElement หรือ PlaceNearbySearchRequestElement เพื่อระบุคำขอแสดงผลลัพธ์ เพิ่ม PlaceContentConfigElement, PlaceStandardContentElement หรือ PlaceAllContentElement เพื่อระบุเนื้อหาที่จะแสดงผล

ตัวอย่างเช่น

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

หากต้องการใช้องค์ประกอบการค้นหาสถานที่ ให้เปิดใช้ Places UI Kit API สำหรับโปรเจ็กต์ในคอนโซล Google Cloud

องค์ประกอบที่กำหนดเอง:
<gmp-place-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceSearchElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceSearchElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceSearchElement
PlaceSearchElement([options])
พารามิเตอร์ 
attributionPosition
ประเภท:  PlaceSearchAttributionPosition optional
ค่าเริ่มต้น: PlaceSearchAttributionPosition.TOP
ตำแหน่งของโลโก้การระบุแหล่งที่มาและปุ่มการเปิดเผยทางกฎหมาย
แอตทริบิวต์ HTML:
  • <gmp-place-search attribution-position="top"></gmp-place-search>
  • <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation
ประเภท:  PlaceSearchOrientation optional
ค่าเริ่มต้น: PlaceSearchOrientation.VERTICAL
ตัวแปรการวางแนว (แนวตั้งหรือแนวนอน) ขององค์ประกอบ
แอตทริบิวต์ HTML:
  • <gmp-place-search orientation="vertical"></gmp-place-search>
  • <gmp-place-search orientation="horizontal"></gmp-place-search>
places
ประเภท:  Array<Place>
อ่านอย่างเดียว อาร์เรย์ของออบเจ็กต์ Place ที่มีรหัส ตำแหน่ง และวิวพอร์ตของสถานที่ที่แสดงผลอยู่ในปัจจุบัน
selectable
ประเภท:  boolean optional
ค่าเริ่มต้น: false
รายการในลิสต์เลือกได้หรือไม่ หากเป็นจริง รายการจะเป็นปุ่มที่ส่งเหตุการณ์ gmp-select เมื่อคลิก นอกจากนี้ยังรองรับการไปยังส่วนต่างๆ และการเลือกด้วยแป้นพิมพ์ที่เข้าถึงได้ด้วย
แอตทริบิวต์ HTML:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
ประเภท:  boolean optional
ค่าเริ่มต้น: false
หากเป็น "จริง" ระบบจะตัดเนื้อหาบางบรรทัดให้พอดีกับบรรทัดเดียวแทนที่จะตัดขึ้นบรรทัดใหม่
แอตทริบิวต์ HTML:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
สีเส้นขอบของปุ่ม "เปิดใน Maps"
--gmp-button-border-radius
รัศมีของเส้นขอบสำหรับปุ่ม "เปิดใน Maps"
--gmp-button-border-width
ความกว้างของขอบสำหรับปุ่ม "เปิดใน Maps"
--gmp-card-border-radius
รัศมีของเส้นขอบสำหรับการ์ดสถานที่
--gmp-dialog-border-radius
รัศมีของเส้นขอบสำหรับกล่องโต้ตอบการเปิดเผยข้อมูลของ Google Maps
--gmp-mat-color-info
สีขององค์ประกอบ UI ที่มีอารมณ์ความรู้สึกเชิงข้อมูล ใช้สำหรับไอคอนทางเข้าที่รองรับเก้าอี้รถเข็น
--gmp-mat-color-negative
สีขององค์ประกอบ UI ที่มีความรู้สึกเชิงลบ ใช้สำหรับป้ายกำกับ "ปิด" สำหรับเวลาทำการของสถานที่
--gmp-mat-color-neutral-container
สีคอนเทนเนอร์สำหรับองค์ประกอบ UI ที่เติมสีแบบเรียบๆ ใช้สำหรับป้ายวันที่ของรีวิวและรูปร่างตัวยึดตำแหน่งการโหลด
--gmp-mat-color-on-neutral-container
สีของข้อความและไอคอนในคอนเทนเนอร์สีกลาง ใช้สำหรับข้อความวันที่ตรวจสอบและข้อความแสดงข้อผิดพลาดในการโหลด
--gmp-mat-color-on-secondary-container
สีของข้อความและไอคอนที่ตัดกับสีคอนเทนเนอร์รอง ใช้สำหรับข้อความและไอคอนของปุ่ม
--gmp-mat-color-on-surface
สีสำหรับข้อความและไอคอนที่ตัดกับสีพื้นผิว ใช้สำหรับส่วนหัวและเนื้อหาของกล่องโต้ตอบ
--gmp-mat-color-on-surface-variant
สีที่เน้นน้อยลงสำหรับข้อความและไอคอนเมื่อเทียบกับสีพื้นผิว ใช้สำหรับข้อมูลสถานที่
--gmp-mat-color-outline-decorative
สีขอบขององค์ประกอบที่ไม่ใช่แบบอินเทอร์แอกทีฟ ใช้สำหรับเส้นขอบคอนเทนเนอร์
--gmp-mat-color-positive
สีขององค์ประกอบ UI ที่มีความรู้สึกเชิงบวก ใช้สำหรับป้ายกำกับ "เปิด" สำหรับเวลาทำการของสถานที่
--gmp-mat-color-primary
สีของข้อความและไอคอนแบบอินเทอร์แอกทีฟตัดกับสีพื้นผิว ใช้สำหรับลิงก์ สัญญาณบอกสถานะการโหลด และไอคอนภาพรวม
--gmp-mat-color-secondary-container
สีเติมที่โดดเด่นน้อยกว่าเมื่อเทียบกับพื้นผิว ใช้สำหรับพื้นหลังของปุ่ม
--gmp-mat-color-surface
สีสำหรับพื้นหลัง ใช้สำหรับพื้นหลังคอนเทนเนอร์และกล่องโต้ตอบ
--gmp-mat-font-body-small
ใช้สำหรับข้อมูลสถานที่
--gmp-mat-font-family
ชุดแบบอักษรพื้นฐานสำหรับข้อความทั้งหมด
--gmp-mat-font-headline-medium
ใช้สำหรับส่วนหัวของกล่องโต้ตอบ
--gmp-mat-font-label-large
ใช้สำหรับเนื้อหาของปุ่ม
--gmp-mat-font-title-medium
ใช้สำหรับชื่อสถานที่
--gmp-mat-spacing-extra-small
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-large
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-medium
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-mat-spacing-small
ใช้สำหรับการเว้นวรรคภายในองค์ประกอบ เช่น ระยะขอบและระยะห่างจากขอบรอบข้อความ
--gmp-star-rating-color
สีของดาวที่เติมในการให้ดาว
--gmp-thumbnail-border-radius
รัศมีเส้นขอบสำหรับภาพขนาดย่อของสถานที่
background-color
ลบล้างสีพื้นหลังขององค์ประกอบ
border
ลบล้างเส้นขอบขององค์ประกอบ
border-radius
ลบล้างรัศมีเส้นขอบขององค์ประกอบ
color-scheme
ระบุรูปแบบสีที่แสดงผลองค์ประกอบนี้ได้ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ color-scheme ค่าเริ่มต้นคือ color-scheme: light dark
font-size
ปรับขนาดข้อความและไอคอนทั้งหมดในองค์ประกอบ ค่าเริ่มต้นคือ 16px
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener
gmp-error
function(event)
อาร์กิวเมนต์ 
เหตุการณ์นี้จะเริ่มทำงานเมื่อคำขอไปยังแบ็กเอนด์ถูกปฏิเสธ (เช่น คีย์ API ไม่ถูกต้อง) เหตุการณ์นี้ไม่เกิดการส่งต่อเหตุการณ์
gmp-load
function(event)
อาร์กิวเมนต์ 
ระบบจะเริ่มเหตุการณ์นี้เมื่อองค์ประกอบโหลดและแสดงผลเนื้อหา เหตุการณ์นี้ไม่เกิดการส่งต่อเหตุการณ์
gmp-select
function(event)
อาร์กิวเมนต์ 
เหตุการณ์นี้จะเริ่มทำงานเมื่อมีการเลือกสถานที่จากรายการ มีออบเจ็กต์ Place ที่มีรหัส สถานที่ตั้ง และวิวพอร์ตของสถานที่ที่เลือก

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

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

ตัวเลือกสำหรับ PlaceSearchElement

attributionPosition optional
ประเภท:  PlaceSearchAttributionPosition optional
orientation optional
ประเภท:  PlaceSearchOrientation optional
selectable optional
ประเภท:  boolean optional
truncationPreferred optional
ประเภท:  boolean optional

ค่าคงที่ PlaceSearchAttributionPosition

google.maps.places.PlaceSearchAttributionPosition ค่าคงที่

ตำแหน่งการระบุแหล่งที่มาสำหรับ PlaceSearchElement

เข้าถึงโดยโทรไปที่ const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

BOTTOM การระบุแหล่งที่มาที่ด้านล่างของ PlaceSearchElement
TOP การระบุแหล่งที่มาที่ด้านบนของ PlaceSearchElement

ค่าคงที่ PlaceSearchOrientation

google.maps.places.PlaceSearchOrientation ค่าคงที่

ตัวแปรการวางแนวสำหรับ PlaceSearchElement

เข้าถึงโดยโทรไปที่ const {PlaceSearchOrientation} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

HORIZONTAL การวางแนวนอน
VERTICAL การวางแนวตั้ง

คลาส PlaceSelectEvent

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

เหตุการณ์นี้จะเริ่มทำงานเมื่อมีการเลือกสถานที่จากรายการสถานที่ เข้าถึงรายการที่เลือกด้วย event.place

คลาสนี้ขยาย Event

เข้าถึงโดยโทรไปที่ const {PlaceSelectEvent} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

place
ประเภท:  Place
สถานที่ที่เลือก

คลาส PlaceNearbySearchRequestElement

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

กำหนดค่า PlaceSearchElement เพื่อโหลดผลลัพธ์ตามคำขอการค้นหาในบริเวณใกล้เคียง ต้องระบุพร็อพเพอร์ตี้ locationRestriction เพื่อให้องค์ประกอบการค้นหาโหลด ระบบจะไม่สนใจพร็อพเพอร์ตี้อื่นๆ ที่กำหนดค่าไว้หากไม่ได้ตั้งค่า locationRestriction เพิ่มองค์ประกอบนี้เป็นองค์ประกอบย่อยของ PlaceSearchElement เพื่อโหลดผลลัพธ์ เช่น

 <gmp-place-search>
  <gmp-place-nearby-search-request
    location-restriction="RADIUS@LAT,LNG"
  ></gmp-place-nearby-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

องค์ประกอบที่กำหนดเอง:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceNearbySearchRequestElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
พารามิเตอร์ 
excludedPrimaryTypes
ประเภท:  Array<string> optional
ค่าเริ่มต้น: null
ประเภทสถานที่หลักที่ยกเว้น
แอตทริบิวต์ HTML:
  • <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes
ประเภท:  Array<string> optional
ค่าเริ่มต้น: null
ประเภทสถานที่ที่ยกเว้น
แอตทริบิวต์ HTML:
  • <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes
ประเภท:  Array<string> optional
ค่าเริ่มต้น: null
รวมประเภทสถานที่หลักแล้ว
แอตทริบิวต์ HTML:
  • <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes
ประเภท:  Array<string> optional
ค่าเริ่มต้น: null
ประเภทสถานที่ที่รวมไว้
แอตทริบิวต์ HTML:
  • <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction
ประเภท:  Circle|CircleLiteral optional
ค่าเริ่มต้น: null
ภูมิภาคที่จะค้นหา ปรับให้เป็น Circle
แอตทริบิวต์ HTML:
  • <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount
ประเภท:  number optional
ค่าเริ่มต้น: null
จำนวนผลลัพธ์สูงสุดที่จะแสดง
แอตทริบิวต์ HTML:
  • <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference
ประเภท:  SearchNearbyRankPreference optional
ค่าเริ่มต้น: null
วิธีจัดอันดับผลลัพธ์ในการตอบกลับ
แอตทริบิวต์ HTML:
  • <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

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

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

ตัวเลือกสำหรับ PlaceNearbySearchRequestElement

excludedPrimaryTypes optional
ประเภท:  Array<string> optional
ประเภทสถานที่หลักที่ยกเว้น ดูรายละเอียดเพิ่มเติมได้ที่ PlaceNearbySearchRequestElement.excludedPrimaryTypes และ SearchNearbyRequest.excludedPrimaryTypes
excludedTypes optional
ประเภท:  Array<string> optional
ประเภทสถานที่ที่ยกเว้น ดูรายละเอียดเพิ่มเติมได้ที่ PlaceNearbySearchRequestElement.excludedTypes และ SearchNearbyRequest.excludedTypes
includedPrimaryTypes optional
ประเภท:  Array<string> optional
ประเภทสถานที่หลักที่รวมอยู่ ดูรายละเอียดเพิ่มเติมได้ที่ PlaceNearbySearchRequestElement.includedPrimaryTypes และ SearchNearbyRequest.includedPrimaryTypes
includedTypes optional
ประเภท:  Array<string> optional
ประเภทสถานที่ที่รวมอยู่ ดูรายละเอียดเพิ่มเติมได้ที่ PlaceNearbySearchRequestElement.includedTypes และ SearchNearbyRequest.includedTypes
locationRestriction optional
ประเภท:  Circle|CircleLiteral optional
ภูมิภาคที่จะค้นหา ดูรายละเอียดเพิ่มเติมได้ที่ PlaceNearbySearchRequestElement.locationRestriction และ SearchNearbyRequest.locationRestriction
maxResultCount optional
ประเภท:  number optional
จำนวนผลลัพธ์สูงสุดที่จะแสดง ดูรายละเอียดเพิ่มเติมได้ที่ PlaceNearbySearchRequestElement.maxResultCount และ SearchNearbyRequest.maxResultCount
rankPreference optional
ประเภท:  SearchNearbyRankPreference optional
วิธีจัดอันดับผลลัพธ์ในการตอบกลับ ดูรายละเอียดเพิ่มเติมได้ที่ PlaceNearbySearchRequestElement.rankPreference และ SearchNearbyRankPreference

คลาส PlaceTextSearchRequestElement

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

กำหนดค่า PlaceSearchElement เพื่อโหลดผลลัพธ์ตามคำขอการค้นหาข้อความ ต้องระบุพร็อพเพอร์ตี้ textQuery เพื่อให้องค์ประกอบการค้นหาโหลด ระบบจะไม่สนใจพร็อพเพอร์ตี้อื่นๆ ที่กำหนดค่าไว้หากไม่ได้ตั้งค่า textQuery เพิ่มองค์ประกอบนี้เป็นองค์ประกอบย่อยของ PlaceSearchElement เพื่อโหลดผลลัพธ์ เช่น

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

องค์ประกอบที่กำหนดเอง:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceTextSearchRequestElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
พารามิเตอร์ 
evConnectorTypes
ประเภท:  Array<EVConnectorType> optional
ค่าเริ่มต้น: null
รายการประเภทหัวชาร์จไฟฟ้า EV ที่ต้องการ
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw
ประเภท:  number optional
ค่าเริ่มต้น: null
อัตราการชาร์จขั้นต่ำที่จำเป็นในหน่วยกิโลวัตต์
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType
ประเภท:  string optional
ค่าเริ่มต้น: null
ประเภทสถานที่ที่ขอ
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow
ประเภท:  boolean optional
ค่าเริ่มต้น: null
ใช้เพื่อจำกัดการค้นหาเฉพาะสถานที่ที่เปิดอยู่ในปัจจุบัน
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias
ประเภท:  LocationBias optional
ค่าเริ่มต้น: null
การให้น้ำหนักพิเศษกับบางตำแหน่งสำหรับการค้นหา ปรับให้เป็น LatLngAltitude | LatLngBounds | Circle | string
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
ค่าเริ่มต้น: null
การจำกัดสถานที่สำหรับการค้นหา ปรับให้เป็น LatLngBounds
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount
ประเภท:  number optional
ค่าเริ่มต้น: null
จำนวนผลลัพธ์สูงสุดที่จะแสดง
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating
ประเภท:  number optional
ค่าเริ่มต้น: null
กรองผลลัพธ์ที่การให้คะแนนของผู้ใช้เฉลี่ยน้อยกว่าขีดจำกัดนี้อย่างเคร่งครัด
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels
ประเภท:  Array<PriceLevel> optional
ค่าเริ่มต้น: null
ใช้เพื่อจำกัดการค้นหาเฉพาะสถานที่ที่มีการทำเครื่องหมายว่ามีระดับราคาที่แน่นอน
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference
ประเภท:  SearchByTextRankPreference optional
ค่าเริ่มต้น: null
วิธีจัดอันดับผลลัพธ์ในการตอบกลับ
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery
ประเภท:  string optional
ค่าเริ่มต้น: null
คำค้นหาที่เป็นข้อความสำหรับการค้นหาข้อความ
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering
ประเภท:  boolean optional
ค่าเริ่มต้น: null
ใช้เพื่อตั้งค่าการกรองประเภทที่เข้มงวดสำหรับ "includedType"
แอตทริบิวต์ HTML:
  • <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

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

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

ตัวเลือกสำหรับ PlaceTextSearchRequestElement

evConnectorTypes optional
ประเภท:  Array<EVConnectorType> optional
รายการประเภทหัวชาร์จไฟฟ้า EV ที่ต้องการ ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.evSearchOptions และ PlaceTextSearchRequestElement.evConnectorTypes
evMinimumChargingRateKw optional
ประเภท:  number optional
อัตราการชาร์จขั้นต่ำที่จำเป็นในหน่วยกิโลวัตต์ ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.evSearchOptions และ PlaceTextSearchRequestElement.evMinimumChargingRateKw
includedType optional
ประเภท:  string optional
ประเภทสถานที่ที่ขอ ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.includedType และ PlaceTextSearchRequestElement.includedType
isOpenNow optional
ประเภท:  boolean optional
ใช้เพื่อจำกัดการค้นหาเฉพาะสถานที่ที่เปิดอยู่ในปัจจุบัน ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.isOpenNow และ PlaceTextSearchRequestElement.isOpenNow
locationBias optional
ประเภท:  LocationBias optional
การให้น้ำหนักพิเศษกับบางตำแหน่งสำหรับการค้นหา ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.locationBias และ PlaceTextSearchRequestElement.locationBias
locationRestriction optional
ประเภท:  LatLngBounds|LatLngBoundsLiteral optional
การจำกัดสถานที่สำหรับการค้นหา ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.locationRestriction และ PlaceTextSearchRequestElement.locationRestriction
maxResultCount optional
ประเภท:  number optional
จำนวนผลลัพธ์สูงสุดที่จะแสดง ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.maxResultCount และ PlaceTextSearchRequestElement.maxResultCount
minRating optional
ประเภท:  number optional
กรองผลลัพธ์ที่การให้คะแนนของผู้ใช้เฉลี่ยน้อยกว่าขีดจำกัดนี้อย่างเคร่งครัด ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.minRating และ PlaceTextSearchRequestElement.minRating
priceLevels optional
ประเภท:  Array<PriceLevel> optional
ใช้เพื่อจำกัดการค้นหาเฉพาะสถานที่ที่มีการทำเครื่องหมายว่ามีระดับราคาที่แน่นอน ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.priceLevels และ PlaceTextSearchRequestElement.priceLevels
rankPreference optional
ประเภท:  SearchByTextRankPreference optional
วิธีจัดอันดับผลลัพธ์ในการตอบกลับ ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.rankPreference และ PlaceTextSearchRequestElement.rankPreference
textQuery optional
ประเภท:  string optional
คำค้นหาที่เป็นข้อความสำหรับการค้นหาข้อความ ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.textQuery และ PlaceTextSearchRequestElement.textQuery
useStrictTypeFiltering optional
ประเภท:  boolean optional
ใช้เพื่อตั้งค่าการกรองประเภทที่เข้มงวดสำหรับ SearchByTextRequest.includedType ดูรายละเอียดเพิ่มเติมได้ที่ SearchByTextRequest.useStrictTypeFiltering และ PlaceTextSearchRequestElement.useStrictTypeFiltering

คลาส Autocomplete

ชั้นเรียน 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()
พารามิเตอร์:  ไม่มี
ค่าที่แสดงผล:  LatLngBounds|undefined ขอบเขตการให้น้ำหนัก
แสดงผลขอบเขตที่การคาดคะเนมีความลำเอียง
getFields
getFields()
พารามิเตอร์:  ไม่มี
ค่าที่แสดงผล:  Array<string>|undefined
แสดงผลฟิลด์ที่จะรวมไว้สำหรับสถานที่ในการตอบกลับรายละเอียดเมื่อดึงข้อมูลรายละเอียดสำเร็จ ดูรายการช่องได้ที่ PlaceResult
getPlace
getPlace()
พารามิเตอร์:  ไม่มี
ค่าที่แสดงผล:  PlaceResult สถานที่ที่ผู้ใช้เลือก
แสดงรายละเอียดของสถานที่ที่ผู้ใช้เลือกหากดึงข้อมูลรายละเอียดสำเร็จ ไม่เช่นนั้น ระบบจะแสดงผลออบเจ็กต์ Place สตับ โดยตั้งค่าพร็อพเพอร์ตี้ name เป็นค่าปัจจุบันของช่องป้อนข้อมูล
setBounds
setBounds(bounds)
พารามิเตอร์ 
  • bounds:  LatLngBounds|LatLngBoundsLiteral optional ขอบเขตการให้น้ำหนักพิเศษกับบางกฎเกณฑ์
ผลลัพธ์:  ไม่มี
กำหนดพื้นที่ที่ต้องการเพื่อแสดงผลลัพธ์ของสถานที่ ผลการค้นหาจะเน้นไปที่พื้นที่นี้ แต่ไม่จำกัดเฉพาะพื้นที่นี้
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, types และ name โดยมี place_id, types และ description ที่แสดงผลโดยบริการเติมข้อความอัตโนมัติ ปิดใช้โดยค่าเริ่มต้น
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
พื้นที่ที่ต้องการให้น้ำหนักการคาดคะเนการค้นหา การคาดคะเนจะเอนเอียงไปทางคำค้นหาที่กำหนดเป้าหมายขอบเขตเหล่านี้ แต่ไม่จำกัดเพียงคำค้นหาดังกล่าว

คลาส PlaceContextualElement

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

วิดเจ็ตที่ใช้โทเค็นบริบทเพื่อแสดงมุมมองภาพรวมของคำตอบจากการเชื่อมต่อแหล่งข้อมูลกับ Google Maps

องค์ประกอบที่กำหนดเอง:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceContextualElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceContextualElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceContextualElement
PlaceContextualElement([options])
พารามิเตอร์ 
contextToken
ประเภท:  string optional
โทเค็นบริบท
แอตทริบิวต์ HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

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

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

ตัวเลือกสำหรับ PlaceContextualElement

contextToken optional
ประเภท:  string optional
โทเค็นบริบทที่ได้จากการตอบกลับของการเชื่อมต่อแหล่งข้อมูลกับ Google Maps

คลาส PlaceContextualListConfigElement

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

องค์ประกอบ HTML ที่กำหนดค่าตัวเลือกสำหรับมุมมองรายการขององค์ประกอบตามบริบทของสถานที่

องค์ประกอบที่กำหนดเอง:
<gmp-place-contextual-list-config layout="compact" map-hidden></gmp-place-contextual-list-config>

คลาสนี้ขยาย HTMLElement

คลาสนี้ใช้ PlaceContextualListConfigElementOptions

เข้าถึงโดยโทรไปที่ const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
พารามิเตอร์ 
layout
ประเภท:  PlaceContextualListLayout optional
เลย์เอาต์
แอตทริบิวต์ HTML:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
ประเภท:  boolean optional
มีการซ่อนแผนที่หรือไม่
แอตทริบิวต์ HTML:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
addEventListener
addEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะฟัง
  • listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent
  • options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive
ค่าที่แสดงผล:  void
ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อมีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
removeEventListener
removeEventListener(type, listener[, options])
พารามิเตอร์ 
  • type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำ Listener เหตุการณ์ออก
  • listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์
  • options:  boolean|EventListenerOptions optional ดูตัวเลือก
ค่าที่แสดงผล:  void
นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

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

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

ตัวเลือกสำหรับ PlaceContextualListConfigElement

layout optional
ประเภท:  PlaceContextualListLayout optional
ค่าเริ่มต้น: PlaceContextualListLayout.VERTICAL
เลย์เอาต์
mapHidden optional
ประเภท:  boolean optional
ค่าเริ่มต้น: false
เป็นจริงหากควรซ่อนแผนที่

ค่าคงที่ PlaceContextualListLayout

google.maps.places.PlaceContextualListLayout ค่าคงที่

รายการเลย์เอาต์ที่องค์ประกอบตามบริบทของสถานที่รองรับสำหรับมุมมองรายการ

เข้าถึงโดยโทรไปที่ const {PlaceContextualListLayout} = await google.maps.importLibrary("places")
ดูไลบรารีใน Maps JavaScript API

COMPACT เลย์เอาต์แบบรายการขนาดกะทัดรัด: รายการจะแสดงเป็นลิงก์ในบรรทัดเดียว โดยมีรายการที่เกินมาอยู่ในรายการแบบเลื่อนลง
VERTICAL เลย์เอาต์แบบรายการแนวตั้ง: รายการจะแสดงผลเป็นการ์ดในรายการแนวตั้ง