Places Widgets

‫BasicPlaceAutocompleteElement class

google.maps.places.BasicPlaceAutocompleteElement class

‫BasicPlaceAutocompleteElement הוא מחלקת משנה של HTMLElement שמספקת רכיב של ממשק משתמש ל-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
כולל רק תוצאות באזורים שצוינו, שמוגדרים כעד 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> אחד שיוצג כסמל לצד פריט החיזוי.
prediction-item
פריט בתפריט הנפתח של החיזויים שמייצג חיזוי יחיד.
prediction-item-icon
הסמל שמוצג מימין לכל פריט ברשימת התחזיות.
prediction-item-main-text
חלק מפריט החיזוי שהוא הטקסט העיקרי של החיזוי. במקרה של מיקומים גיאוגרפיים, הערך הזה מכיל שם מקום, כמו 'סידני', או שם רחוב ומספר, כמו 'רחוב המלך 10'. כברירת מחדל, הטקסט הראשי של פריט החיזוי הוא שחור. אם יש טקסט נוסף בפריט החיזוי, הוא נמצא מחוץ ל-prediction-item-main-text ומקבל את הסגנון שלו מ-prediction-item. כברירת מחדל, הוא צבוע באפור. הטקסט הנוסף הוא בדרך כלל כתובת.
prediction-item-match
החלק של התחזית שהוחזרה שתואם לקלט של המשתמש. כברירת מחדל, הטקסט התואם מודגש. חשוב לשים לב שהטקסט התואם יכול להופיע בכל מקום בתוך prediction-item. הוא לא בהכרח חלק מהרכיב prediction-item-main-text.
prediction-item-selected
הפריט כשהמשתמש מנווט אליו באמצעות המקלדת. הערה: הפריטים שנבחרו יושפעו גם מהסגנונות של חלקי הפריטים האלה וגם מהסגנונות של חלקי הפריטים שנוצרו על ידי חיזוי.
prediction-list
הרכיב החזותי שמכיל את רשימת החיזויים שמוחזרים על ידי שירות ההשלמה האוטומטית של מקומות. הרשימה הזו מופיעה כרשימה נפתחת מתחת ל-PlaceAutocompleteElement.
background-color
הגדרה שמשנה את צבע הרקע של הרכיב.
border
הגדרה שמשנה את הגבול של הרכיב.
border-radius
המאפיין מחליף את רדיוס הגבולות של האלמנט.
color-scheme
מציין את העיצוב שבו אפשר להציג את הרכיב הזה. פרטים נוספים זמינים בcolor-scheme מאמרי העזרה. ברירת המחדל היא color-scheme: light dark.
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:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • options:  boolean|EventListenerOptions optional אפשרויות
ערך מוחזר:  void
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.
gmp-error
function(errorEvent)
ארגומנטים: 
האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.
gmp-select
function(placeSelectEvent)
ארגומנטים: 
האירוע הזה מופעל כשמשתמש בוחר תחזית של מקום. מכיל אובייקט Place.

‫BasicPlaceAutocompleteElementOptions interface

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

‫PlaceAutocompleteElement class

google.maps.places.PlaceAutocompleteElement class

‫PlaceAutocompleteElement הוא מחלקת משנה של HTMLElement שמספקת רכיב ממשק משתמש ל-Places Autocomplete API. ‫

PlaceAutocompleteElement משתמש אוטומטית ב-AutocompleteSessionTokens באופן פנימי כדי לקבץ את שלבי השאילתה והבחירה של חיפוש ההשלמה האוטומטית של משתמש.

השיחה הראשונה אל 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>
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>
prediction-item-icon
במשבצת הזו אפשר להזין בדיוק רכיב <template> אחד שיוצג כסמל לצד פריט החיזוי.
prediction-item
פריט בתפריט הנפתח של החיזויים שמייצג חיזוי יחיד.
prediction-item-icon
הסמל שמוצג מימין לכל פריט ברשימת התחזיות.
prediction-item-main-text
חלק מפריט החיזוי שהוא הטקסט העיקרי של החיזוי. במקרה של מיקומים גיאוגרפיים, הערך הזה מכיל שם מקום, כמו 'סידני', או שם רחוב ומספר, כמו 'רחוב המלך 10'. כברירת מחדל, הטקסט הראשי של פריט החיזוי הוא שחור. אם יש טקסט נוסף בפריט החיזוי, הוא נמצא מחוץ ל-prediction-item-main-text ומקבל את הסגנון שלו מ-prediction-item. כברירת מחדל, הוא צבוע באפור. הטקסט הנוסף הוא בדרך כלל כתובת.
prediction-item-match
החלק של התחזית שהוחזרה שתואם לקלט של המשתמש. כברירת מחדל, הטקסט התואם מודגש. חשוב לשים לב שהטקסט התואם יכול להופיע בכל מקום בתוך prediction-item. הוא לא בהכרח חלק מהרכיב prediction-item-main-text.
prediction-item-selected
הפריט כשהמשתמש מנווט אליו באמצעות המקלדת. הערה: הפריטים שנבחרו יושפעו גם מהסגנונות של חלקי הפריטים האלה וגם מהסגנונות של חלקי הפריטים שנוצרו על ידי חיזוי.
prediction-list
הרכיב החזותי שמכיל את רשימת החיזויים שמוחזרים על ידי שירות ההשלמה האוטומטית של מקומות. הרשימה הזו מופיעה כרשימה נפתחת מתחת ל-PlaceAutocompleteElement.
background-color
הגדרה שמשנה את צבע הרקע של הרכיב.
border
הגדרה שמשנה את הגבול של הרכיב.
border-radius
המאפיין מחליף את רדיוס הגבולות של האלמנט.
color-scheme
מציין את העיצוב שבו אפשר להציג את הרכיב הזה. פרטים נוספים זמינים בcolor-scheme מאמרי העזרה. ברירת המחדל היא color-scheme: light dark.
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:  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 interface

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

‪PlacePredictionSelectEvent class

google.maps.places.PlacePredictionSelectEvent class

האירוע הזה נוצר אחרי שהמשתמש בוחר פריט חיזוי באמצעות PlaceAutocompleteElement. ניגשים לבחירה באמצעות event.placePrediction. ‫

המרת placePrediction ל-Place באמצעות קריאה ל-PlacePrediction.toPlace.

הכיתה הזו היא הרחבה של Event.

אפשר להתקשר אל const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
placePrediction
סוג:  PlacePrediction
כדי להמיר את זה ל-Place, מתקשרים אל PlacePrediction.toPlace.

‫PlaceContextualElement class

google.maps.places.PlaceContextualElement class

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

ממשק PlaceContextualElementOptions

google.maps.places.PlaceContextualElementOptions ממשק

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

‫PlaceContextualListConfigElement class

google.maps.places.PlaceContextualListConfigElement class

רכיב HTML שמגדיר אפשרויות לתצוגת הרשימה של רכיב ההקשר של המקום.

רכיב בהתאמה אישית:
<gmp-place-contextual-list-config layout="compact" map-hidden map-mode="none"></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>
mapMode
סוג:  PlaceContextualListMapMode optional
מצב המפה שבו נעשה שימוש ברכיב ההקשרי של המקום עבור רשימת מקומות.
מאפיין HTML:
  • <gmp-place-contextual-list-config map-mode="none"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="roadmap"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="hybrid"></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:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • options:  boolean|EventListenerOptions optional אפשרויות
ערך מוחזר:  void
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PlaceContextualListConfigElementOptions interface

google.maps.places.PlaceContextualListConfigElementOptions ממשק

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

PlaceContextualListLayout constants

google.maps.places.PlaceContextualListLayout constants

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

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

PlaceContextualListMapMode constants

google.maps.places.PlaceContextualListMapMode constants

מצב המפה שבו נעשה שימוש ברכיב ההקשרי של המקום עבור רשימת מקומות.

אפשר להתקשר אל const {PlaceContextualListMapMode} = await google.maps.importLibrary("places") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
HYBRID שכבה שקופה של רחובות ראשיים בתמונת לוויין, או תמונות פוטוריאליסטיות בתלת-מימד.
NONE אין מפה.
ROADMAP מפה רגילה של רחובות בדו-ממד.

‫PlaceDetailsElement class

google.maps.places.PlaceDetailsElement class

הצגת פרטים על מקום בפריסה מלאה. מוסיפים 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
רדיוס הגבול של הכפתור 'פתיחה במפות'.
--gmp-button-border-width
רוחב קו הגבול של הלחצן 'פתיחה במפות'.
--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
צבע הקונטיינר לרכיבי ממשק משתמש ניטרליים עם מילוי. הוא משמש ל-placeholders של תמונות ולתג של תאריך הפרסום של הביקורת.
--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
צבע המילוי פחות בולט על פני השטח, ברכיבים נסוגים כמו כפתורים בצבע אחד. הצבע הזה משמש לרקע של הלחצן 'פתיחה במפות'.
--gmp-mat-color-surface
צבע לרקעים. הצבע הזה משמש לרקעים של הרכיב ושל תיבת הגילוי הנאות במפות Google.
--gmp-mat-font-body-medium
המשתנה הזה משמש לציון הכתובת, הדירוג, הסוג, המחיר, סטטוס הפתיחה, שעות הפתיחה, הביקורת, מספר הטלפון, האתר, הקוד פלוס, התכונות המובילות וטקסט הגוף של המקום בתיבת הדו-שיח של הגילוי הנאות במפות 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 מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים.
  • ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • options:  boolean|EventListenerOptions optional אפשרויות
ערך מוחזר:  void
מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.
gmp-error
function(event)
ארגומנטים: 
האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.
gmp-load
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהרכיב נטען והתוכן שלו מוצג. האירוע הזה לא מתפשט.

‫PlaceDetailsElementOptions interface

google.maps.places.PlaceDetailsElementOptions ממשק

אפשרויות לגבי PlaceDetailsElement.

‫PlaceDetailsCompactElement class

google.maps.places.PlaceDetailsCompactElement class

הצגת פרטים על מקום מסוים בפריסה קומפקטית. מוסיפים את התג 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
צבע הגבול של הלחצן 'פתיחה ב-Maps'.
--gmp-button-border-radius
רדיוס הגבול של הכפתור 'פתיחה במפות'.
--gmp-button-border-width
רוחב קו הגבול של הלחצן 'פתיחה במפות'.
--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
צבע המילוי פחות בולט על פני השטח, ברכיבים נסוגים כמו כפתורים בצבע אחד. הצבע הזה משמש לרקע של הלחצן 'פתיחה במפות'.
--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 ולטקסט של ייחוס הביקורת בגלריית התמונות.
--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:  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 constants

google.maps.places.PlaceDetailsOrientation constants

וריאציות של כיוון התמונה עבור PlaceDetailsCompactElement.

אפשר להתקשר אל const {PlaceDetailsOrientation} = await google.maps.importLibrary("places") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
HORIZONTAL כיוון אופקי.
VERTICAL כיוון אנכי.

‫PlaceDetailsPlaceRequestElement class

google.maps.places.PlaceDetailsPlaceRequestElement class

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

‫PlaceDetailsPlaceRequestElementOptions interface

google.maps.places.PlaceDetailsPlaceRequestElementOptions ממשק

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

‫PlaceDetailsLocationRequestElement class

google.maps.places.PlaceDetailsLocationRequestElement class

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

‫PlaceDetailsLocationRequestElementOptions interface

google.maps.places.PlaceDetailsLocationRequestElementOptions ממשק

אפשרויות לגבי PlaceDetailsLocationRequestElement.
location optional
המיקום שבו יוצג המקום.

‫PlaceSearchElement class

google.maps.places.PlaceSearchElement class

הצגת התוצאות של חיפוש מקום ברשימה. מוסיפים 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>

כדי להשתמש ברכיב 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
צבע הגבול של הכפתור 'פתיחה במפות'.
--gmp-button-border-radius
רדיוס הגבול של הכפתור 'פתיחה במפות'.
--gmp-button-border-width
רוחב קו הגבול של הלחצן 'פתיחה במפות'.
--gmp-card-border-radius
רדיוס הגבול של כרטיסי המקומות.
--gmp-dialog-border-radius
רדיוס הגבול של תיבת הדו-שיח לגילוי נאות במפות Google.
--gmp-mat-color-info
הצבע של רכיבי ממשק המשתמש עם סנטימנט מידעני. משמש לסמל של כניסה נגישה.
--gmp-mat-color-negative
צבע של רכיבי ממשק משתמש עם סנטימנט שלילי. השדה הזה משמש לציון שעות הפתיחה של מקום באמצעות התווית 'סגור'.
--gmp-mat-color-neutral-container
צבע הקונטיינר לרכיבי ממשק משתמש ניטרליים עם מילוי. הנתונים האלה משמשים להצגת תגי תאריך של ביקורות ולטעינת צורות של placeholder.
--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 מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים.
  • ‫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 interface

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 constants

google.maps.places.PlaceSearchAttributionPosition constants

מיקומי השיוך של PlaceSearchElement.

אפשר להתקשר אל const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
BOTTOM שיוך בתחתית של PlaceSearchElement
TOP שיוך בחלק העליון של PlaceSearchElement

PlaceSearchOrientation קבועים

google.maps.places.PlaceSearchOrientation constants

וריאציות של כיוון התמונה עבור PlaceSearchElement.

אפשר להתקשר אל const {PlaceSearchOrientation} = await google.maps.importLibrary("places") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
HORIZONTAL כיוון אופקי.
VERTICAL כיוון אנכי.

‫PlaceSelectEvent class

google.maps.places.PlaceSelectEvent class

האירוע הזה מופעל כשבוחרים מקום מתוך רשימת מקומות. ניגשים לבחירה באמצעות event.place.

הכיתה הזו היא הרחבה של Event.

אפשר להתקשר אל const {PlaceSelectEvent} = await google.maps.importLibrary("places") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
place
סוג:  Place
המקום שנבחר.

‫PlaceNearbySearchRequestElement class

google.maps.places.PlaceNearbySearchRequestElement class

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

PlaceNearbySearchRequestElementOptions interface

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 class

google.maps.places.PlaceTextSearchRequestElement class

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

‫PlaceTextSearchRequestElementOptions interface

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
הטיה לפי מיקום בחיפוש. פרטים נוספים מופיעים במאמרים 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.

‫Autocomplete class

google.maps.places.Autocomplete class

ווידג'ט שמספק תחזיות לגבי מקומות על סמך קלט טקסט של משתמש. הוא מצורף לרכיב קלט מסוג text ומאזין להזנת טקסט בשדה הזה. רשימת התחזיות מוצגת כרשימה נפתחת, והיא מתעדכנת תוך כדי הזנת הטקסט.

הכיתה הזו היא הרחבה של MVCObject.

אפשר להתקשר אל const {Autocomplete} = await google.maps.importLibrary("places") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
Autocomplete
Autocomplete(inputField[, opts])
פרמטרים: 
הפונקציה יוצרת מופע חדש של Autocomplete שמצורף לשדה הטקסט של הקלט שצוין עם האפשרויות שניתנו.
getBounds
getBounds()
פרמטרים:  אין
ערך ההחזרה:  LatLngBounds|undefined הגבולות של הטיית התוצאה.
הפונקציה מחזירה את הגבולות שבהם ההטיות של התחזיות מתרחשות.
getFields
getFields()
פרמטרים:  אין
ערך מוחזר:  Array<string>|undefined
הפונקציה מחזירה את השדות שצריך לכלול בתגובה עם הפרטים של המקום, אם הפרטים נשלפו בהצלחה. רשימת השדות זמינה בכתובת PlaceResult.
getPlace
getPlace()
פרמטרים:  אין
ערך ההחזרה:  PlaceResult המקום שנבחר על ידי המשתמש.
מחזירה את פרטי המקום שנבחר על ידי המשתמש אם הפרטים אוחזרו בהצלחה. אחרת, הפונקציה מחזירה אובייקט Place מסוג stub, כשהמאפיין name מוגדר לערך הנוכחי של שדה הקלט.
setBounds
setBounds(bounds)
פרמטרים: 
ערך מוחזר:  אין
הגדרת האזור המועדף שבו יוחזרו תוצאות של מקומות. התוצאות מוטות לכיוון האזור הזה, אבל לא מוגבלות אליו.
setComponentRestrictions
setComponentRestrictions(restrictions)
פרמטרים: 
ערך מוחזר:  אין
הגדרת ההגבלות על הרכיב. הגבלות על רכיבים משמשות להגבלת התחזיות רק לאלה שנמצאות ברכיב האב. לדוגמה, המדינה.
setFields
setFields(fields)
פרמטרים: 
  • 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, עם הערכים place_id, ‏ types ו-description שמוחזרים על ידי שירות ההשלמה האוטומטית. מושבת כברירת מחדל.
strictBounds optional
סוג:  boolean optional
ערך בוליאני שמציין שווידג'ט ההשלמה האוטומטית צריך להחזיר רק את המקומות שנמצאים בתוך הגבולות של הווידג'ט בזמן שליחת השאילתה. הגדרה של strictBounds לערך false (שהוא ברירת המחדל) תגרום להטיה של התוצאות למקומות שנכללים בגבולות, אבל לא תגביל אותן רק למקומות האלה.
types optional
סוג:  Array<string> optional
סוגי החיזויים שיוחזרו. ב מדריך למפתחים מפורטים הסוגים הנתמכים. אם לא מציינים סוגים, כל הסוגים יוחזרו.

google.maps.places.SearchBox class

ווידג'ט שמספק חיזויים של שאילתות על סמך קלט הטקסט של המשתמש. הוא מצורף לרכיב קלט מסוג 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 interface

google.maps.places.SearchBoxOptions ממשק

האפשרויות שאפשר להגדיר באובייקט SearchBox.
bounds optional
האזור שלפיו יוטו תחזיות השאילתות. התחזיות מוטות לטובת שאילתות שמטרגטות את הגבולות האלה, אבל לא מוגבלות אליהן.