Places Widgets

‫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
פריט בתפריט הנפתח של החיזויים שמייצג חיזוי יחיד.
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.
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
BetaremoveEventListener
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.
locationBias optional
סוג:  LocationBias optional
locationRestriction optional
סוג:  LocationRestriction optional
name optional
סוג:  string optional
requestedLanguage optional
סוג:  string 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.

‫PlaceAutocompleteRequestErrorEvent class

google.maps.places.PlaceAutocompleteRequestErrorEvent class

האירוע הזה מופעל על ידי PlaceAutocompleteElement כשיש בעיה בבקשת הרשת.

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

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

‫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.
contextToken
סוג:  string optional
טוקן ההקשר.
מאפיין HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה.
  • ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של