Places Widgets

המחלקה PlaceAutocompleteElement

מחלקה google.maps.places.PlaceAutocompleteElement

‫PlaceAutocompleteElement הוא תת-מחלקה של HTMLElement שמספקת רכיב ממשק משתמש ל-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
הצגת תוצאות רק באזורים שצוינו, שמוגדרים כעד 15 קודי אזור של CLDR באורך שני תווים. קבוצה ריקה לא תגביל את התוצאות. אם גם 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 (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-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
חלק מ-prediction-item שהוא הטקסט הראשי של החיזוי. במיקומים גיאוגרפיים, השדה הזה מכיל שם של מקום, כמו "תל אביב", או שם רחוב ומספר, כמו "רחוב המלך ג'ורג' 10". כברירת מחדל, הטקסט הראשי של פריט החיזוי הוא בצבע שחור. אם יש טקסט נוסף ב-prediction-item, הוא נמצא מחוץ ל-prediction-item-main-text והסגנון שלו עובר בירושה מ-prediction-item. כברירת מחדל, הוא בצבע אפור. הטקסט הנוסף הוא בדרך כלל כתובת.
prediction-item-match
החלק של החיזוי שהוחזר שתואם לקלט של המשתמש. כברירת מחדל, הטקסט התואם מודגש. שימו לב שהטקסט התואם יכול להיות בכל מקום בתוך prediction-item. הוא לא בהכרח חלק מ-prediction-item-main-text.
prediction-item-selected
הפריט כשהמשתמש מנווט אליו באמצעות המקלדת. הערה: הפריטים שנבחרו יושפעו גם מהסגנונות של החלק הזה וגם מהסגנונות של החלק prediction-item.
prediction-list
הרכיב החזותי שמכיל את רשימת החיזויים שהוחזרו על ידי שירות ההשלמה האוטומטית למקומות. הרשימה הזו מופיעה כרשימה נפתחת מתחת ל-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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event 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 שמספקת רכיב ממשק משתמש ל-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
הצגת תוצאות רק באזורים שצוינו, שמוגדרים כעד 15 קודי אזור של CLDR באורך שני תווים. קבוצה ריקה לא תגביל את התוצאות. אם גם 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 (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-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
חלק מ-prediction-item שהוא הטקסט הראשי של החיזוי. במיקומים גיאוגרפיים, השדה הזה מכיל שם של מקום, כמו "תל אביב", או שם רחוב ומספר, כמו "רחוב המלך ג'ורג' 10". כברירת מחדל, הטקסט הראשי של פריט החיזוי הוא בצבע שחור. אם יש טקסט נוסף ב-prediction-item, הוא נמצא מחוץ ל-prediction-item-main-text והסגנון שלו עובר בירושה מ-prediction-item. כברירת מחדל, הוא בצבע אפור. הטקסט הנוסף הוא בדרך כלל כתובת.
prediction-item-match
החלק של החיזוי שהוחזר שתואם לקלט של המשתמש. כברירת מחדל, הטקסט התואם מודגש. שימו לב שהטקסט התואם יכול להיות בכל מקום בתוך prediction-item. הוא לא בהכרח חלק מ-prediction-item-main-text.
prediction-item-selected
הפריט כשהמשתמש מנווט אליו באמצעות המקלדת. הערה: הפריטים שנבחרו יושפעו גם מהסגנונות של החלק הזה וגם מהסגנונות של החלק prediction-item.
prediction-list
הרכיב החזותי שמכיל את רשימת החיזויים שהוחזרו על ידי שירות ההשלמה האוטומטית למקומות. הרשימה הזו מופיעה כרשימה נפתחת מתחת ל-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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event 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
צבע הגבול של הכפתור "פתיחה במפות".
--gmp-button-border-radius
רדיוס הגבול של הכפתור "פתיחה במפות Google".
--gmp-button-border-width
רוחב הגבול של הכפתור "פתיחה במפות Google".
--gmp-collage-border-radius-outer
רדיוס הגבול של הפינות החיצוניות של קולאז' המדיה.
--gmp-dialog-border-radius
רדיוס הגבול של תיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-color-disabled-surface
צבע הרקע שנועד להעביר מצבים מושבתים או חוסר נוכחות. משמש לכוכבי ביקורת ריקים.
--gmp-mat-color-info
צבע של רכיבים בממשק המשתמש עם סנטימנט אינפורמטיבי. משמש לסמל של כיסא הגלגלים.
--gmp-mat-color-negative
הצבע של רכיבים בממשק המשתמש עם סנטימנט שלילי. הטקסט "סגור" בסטטוס "פתוח עכשיו".
--gmp-mat-color-neutral-container
צבע הקונטיינר של רכיבים ניטרליים בממשק המשתמש. משמש לפלייסהולדרים של תמונות ולתג של תאריך פרסום הביקורת.
--gmp-mat-color-on-neutral-container
צבע הטקסט והסמלים לעומת צבע המאגר הניטרלי. משמש לתג של תאריך פרסום הביקורת ולתג של זמינות מטען לרכב חשמלי כשהוא לא זמין.
--gmp-mat-color-on-positive-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
הצבע של רכיבים בממשק המשתמש עם סנטימנט חיובי. הטקסט "פתוח" בסטטוס "פתוח עכשיו".
--gmp-mat-color-positive-container
צבע המאגר של רכיבים בממשק המשתמש שמביעים רגש חיובי. הערך הזה משמש לתג הזמינות של מטען לרכב חשמלי, אם הוא זמין.
--gmp-mat-color-primary
הצבע של הטקסט והסמלים האינטראקטיביים לעומת צבע המשטח. משמש למספר הביקורות, לקישורים בתיבת הדו-שיח של הגילויים הנאותים במפות Google, לקישור לאתר, לסמלים בכרטיסייה "סקירה כללית" ולצבע הטקסט, המיקוד והמעבר מעל הכותרות בסרגל הכרטיסיות.
--gmp-mat-color-secondary-container
צבע מילוי פחות בולט על פני השטח, לרכיבים פחות בולטים כמו כפתורים בצבע אחד. משמש לרקע של הלחצן "פתיחה במפות Google".
--gmp-mat-color-surface
צבע לרקעים. משמש לרקעים של הרכיב ולתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-body-medium
משמש לכתובת, לדירוג, לסוג, למחיר, לסטטוס "פתוח עכשיו", לשעות הפתיחה, לביקורת, למספר הטלפון, לאתר, ל-Plus Code, לתכונות המובילות ולטקסט הראשי בתיבת הדו-שיח של הגילוי הנאות במפות Google.
--gmp-mat-font-body-small
הטקסט הזה משמש כגוף הטקסט ברשימת התכונות בכרטיסייה "מידע כללי".
--gmp-mat-font-display-small
משמש לשם המקום ולטקסט של כל כותרת תכונה בכרטיסייה "מידע כללי".
--gmp-mat-font-family
משפחת הגופנים הבסיסית שמשמשת לכל הטקסט.
--gmp-mat-font-headline-medium
משמש כטקסט הכותרת בתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-label-large
הצבע הזה משמש לכותרות של הכרטיסיות, לכפתור "פתיחה במפות Google", לטקסט לציון קרדיט למשתמש שכתב את הביקורת בגלריית התמונות, לטקסט לציון קרדיט למשתמש שכתב את הביקורת בקטע הביקורות ולקישורים בתיבת הדו-שיח של הגילויים הנאותים במפות Google.
--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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event 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
אם הערך הוא true, השם והכתובת של המקום נחתכים כדי להתאים לשורה אחת במקום לעבור לשורה הבאה.
מאפיין HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-button-border-color
צבע הגבול של הכפתור "פתיחה במפות".
--gmp-button-border-radius
רדיוס הגבול של הכפתור "פתיחה במפות Google".
--gmp-button-border-width
רוחב הגבול של הכפתור "פתיחה במפות Google".
--gmp-dialog-border-radius
רדיוס הגבול של תיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-color-info
צבע של רכיבים בממשק המשתמש עם סנטימנט אינפורמטיבי. משמש לסמל של כיסא הגלגלים.
--gmp-mat-color-negative
הצבע של רכיבים בממשק המשתמש עם סנטימנט שלילי. הטקסט "סגור" בסטטוס "פתוח עכשיו".
--gmp-mat-color-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
הצבע של רכיבים בממשק המשתמש עם סנטימנט חיובי. הטקסט "פתוח" בסטטוס "פתוח עכשיו".
--gmp-mat-color-primary
הצבע של הטקסט והסמלים האינטראקטיביים לעומת צבע המשטח. משמש לספירת הביקורות, וגם לקישורים בתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-color-secondary-container
צבע מילוי פחות בולט על פני השטח, לרכיבים פחות בולטים כמו כפתורים בצבע אחד. משמש לרקע של הלחצן "פתיחה במפות Google".
--gmp-mat-color-surface
צבע לרקעים. משמש לרקעים של הרכיב ולתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-body-medium
משמש לטקסט הראשי בתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-body-small
משמש לכתובת, לדירוג, לסוג, למחיר ולסטטוס "פתוח עכשיו" של המקום.
--gmp-mat-font-family
משפחת הגופנים הבסיסית שמשמשת לכל הטקסט.
--gmp-mat-font-headline-medium
משמש כטקסט הכותרת בתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-label-large
משמש ללחצן "פתיחה במפות Google", וגם לקישורים בתיבת הדו-שיח של גילוי נאות במפות Google ולטקסט לציון קרדיט למשתמש שכתב את הביקורת בגלריית התמונות.
--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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.
gmp-error
function(event)
ארגומנטים: 
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע.
gmp-load
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהרכיב נטען ומציג את התוכן שלו. האירוע הזה לא מבעבע.

הממשק PlaceDetailsCompactElementOptions

ממשק google.maps.places.PlaceDetailsCompactElementOptions

אפשרויות לגבי PlaceDetailsCompactElement.
orientation optional
סוג:  PlaceDetailsOrientation optional
PlaceDetailsCompactElement.orientation.
truncationPreferred optional
סוג:  boolean optional
PlaceDetailsCompactElement.truncationPreferred.

קבועים של 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
אובייקט המקום, המזהה או שם המשאב שרוצים להציג את הפרטים שלו ברכיב Place Details Compact. המאפיין הזה משקף את המאפיין כשם משאב.
מאפיין 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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.

ממשק PlaceDetailsPlaceRequestElementOptions

ממשק google.maps.places.PlaceDetailsPlaceRequestElementOptions

אפשרויות לגבי PlaceDetailsPlaceRequestElement.
place optional
סוג:  Place|string optional
הצגה של PlaceDetailsPlaceRequestElement.place

המחלקה 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
המיקום שבו יוצגו הפרטים ברכיב Place Details. הפונקציה מנרמלת ל-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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event 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.TOP
המיקום של לוגו השיוך (Attribution) וכפתור הגילוי הנאות כנדרש בחוק.
מאפיין 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
אם אפשר לבחור את הפריטים ברשימה או לא. אם הערך הוא true, הפריטים ברשימה יהיו כפתורים ששולחים את האירוע gmp-select כשלוחצים עליהם. יש גם תמיכה בניווט ובבחירה באמצעות מקלדת נגישה.
מאפיין HTML:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
סוג:  boolean optional
ברירת המחדל: false
אם הערך הוא true, שורות תוכן מסוימות נחתכות כדי להתאים לשורה אחת במקום לעבור לשורה הבאה.
מאפיין HTML:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
צבע הגבול של הכפתור "פתיחה במפות Google".
--gmp-button-border-radius
רדיוס הגבולות של הכפתור "פתיחה במפות Google".
--gmp-button-border-width
רוחב הגבול של הכפתור "פתיחה במפות Google".
--gmp-card-border-radius
רדיוס הגבולות של כרטיסי המקומות.
--gmp-dialog-border-radius
רדיוס הגבולות של תיבת הדו-שיח של הגילוי הנאות במפות Google.
--gmp-mat-color-info
צבע של רכיבים בממשק המשתמש עם סנטימנט אינפורמטיבי. משמש לסמל של כניסה נגישה.
--gmp-mat-color-negative
הצבע של רכיבים בממשק המשתמש עם סנטימנט שלילי. התווית "סגור" בשעות הפתיחה של מקום.
--gmp-mat-color-neutral-container
צבע הקונטיינר של רכיבים ניטרליים בממשק המשתמש. משמש לתגי תאריך של ביקורות ולצורות של פלייסהולדרים לטעינה.
--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
הצבע של רכיבים בממשק המשתמש עם סנטימנט חיובי. משמש לתווית "פתוח" בשעות הפתיחה של מקום.
--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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event 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
PlaceSearchElement.attributionPosition.
orientation optional
סוג:  PlaceSearchOrientation optional
PlaceSearchElement.orientation.
selectable optional
סוג:  boolean optional
הצגה של PlaceSearchElement.selectable
truncationPreferred optional
סוג:  boolean optional
PlaceSearchElement.truncationPreferred.

קבועים של PlaceSearchAttributionPosition

google.maps.places.PlaceSearchAttributionPosition קבועים

מיקומי השיוך (Attribution) של 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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event 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
רשימת סוגי המחברים המועדפים לרכב חשמלי.
מאפיין 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
ברירת המחדל: 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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.

ממשק PlaceTextSearchRequestElementOptions

ממשק google.maps.places.PlaceTextSearchRequestElementOptions

אפשרויות לגבי PlaceTextSearchRequestElement.
evConnectorTypes optional
סוג:  Array<EVConnectorType> optional
רשימת סוגי המחברים המועדפים לרכב חשמלי. פרטים נוספים מופיעים ב-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
הגבלת מיקום לחיפוש. פרטים נוספים מופיעים ב-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.

השלמה אוטומטית class

מחלקה 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 עם מאפיין 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.
bounds 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, עם הערכים של מזהה מקום, ‏ 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
האזור שאליו רוצים להטות את החיזויים של השאילתות. התחזיות נוטות לשאילתות שמטרגטות את הגבולות האלה, אבל לא מוגבלות אליהן.

המחלקה PlaceContextualElement

מחלקה google.maps.places.PlaceContextualElement

ווידג'ט שמשתמש בטוקן של הקשר כדי להציג תצוגה מותאמת מיקום של התשובה מ"עיגון בעזרת מפות Google".

רכיב בהתאמה אישית:
<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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.

ממשק PlaceContextualElementOptions

ממשק google.maps.places.PlaceContextualElementOptions

אפשרויות לגבי PlaceContextualElement.
contextToken optional
סוג:  string optional
טוקן של הקשר שסופק על ידי התגובה של "עיגון בעזרת מפות Google".

המחלקה 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 מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.

ממשק PlaceContextualListConfigElementOptions

ממשק google.maps.places.PlaceContextualListConfigElementOptions

אפשרויות ל-PlaceContextualListConfigElement.
layout optional
סוג:  PlaceContextualListLayout optional
ברירת המחדל: PlaceContextualListLayout.VERTICAL
הפריסה.
mapHidden optional
סוג:  boolean optional
ברירת המחדל: false
אם המפה צריכה להיות מוסתרת, הערך הוא True.

ערכים קבועים של PlaceContextualListLayout

google.maps.places.PlaceContextualListLayout קבועים

רשימת הפריסות שבהן הרכיב ההקשרי של המקום תומך בתצוגת הרשימה.

כדי לקבל גישה, צריך לקרוא ל: const {PlaceContextualListLayout} = await google.maps.importLibrary("places").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.
COMPACT פריסת רשימה קומפקטית: פריטי הרשימה מוצגים כקישורים בשורה אחת, עם גלישה לרשימה נפתחת.
VERTICAL פריסת רשימה אנכית: הפריטים ברשימה מוצגים ככרטיסים ברשימה אנכית.