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) פרמטרים:  options:  BasicPlaceAutocompleteElementOptions

מאפיינים
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	סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional נקודת המוצא שממנה יחושב המרחק. אם לא מציינים את המרחק, הוא לא מחושב. אם הגובה מצוין, הוא לא משמש לחישוב. מאפיין 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.

מאפייני CSS
background-color	הגדרה שמשנה את צבע הרקע של הרכיב.
border	הגדרה שמשנה את הגבול של הרכיב.
border-radius	המאפיין מחליף את רדיוס הגבולות של האלמנט.
color-scheme	מציין את העיצוב שבו אפשר להציג את הרכיב הזה. פרטים נוספים זמינים בcolor-scheme מאמרי העזרה. ברירת המחדל היא color-scheme: light dark.

Methods
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) ארגומנטים:  errorEvent:  Event האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.
gmp-select	function(placeSelectEvent) ארגומנטים:  placeSelectEvent:  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	סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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) פרמטרים:  options:  PlaceAutocompleteElementOptions

מאפיינים
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	סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional נקודת המוצא שממנה יחושב המרחק. אם לא מציינים את המרחק, הוא לא מחושב. אם הגובה מצוין, הוא לא משמש לחישוב. מאפיין 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.

מאפייני CSS
background-color	הגדרה שמשנה את צבע הרקע של הרכיב.
border	הגדרה שמשנה את הגבול של הרכיב.
border-radius	המאפיין מחליף את רדיוס הגבולות של האלמנט.
color-scheme	מציין את העיצוב שבו אפשר להציג את הרכיב הזה. פרטים נוספים זמינים בcolor-scheme מאמרי העזרה. ברירת המחדל היא color-scheme: light dark.

Methods
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) ארגומנטים:  errorEvent:  Event האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.
gmp-select	function(placePredictionSelectEvent) ארגומנטים:  placePredictionSelectEvent:  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	סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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.

‫PlaceAutocompleteRequestErrorEvent class

google.maps.places.PlaceAutocompleteRequestErrorEvent class

הוצא משימוש: האירוע gmp-requesterror ימשיך להיות מופעל בערוץ הבטא, אבל לא יופעל בערוץ אלפא או בגרסה הסופית. לצורך מיגרציה, כדאי להמשיך להאזין לאירוע gmp-requesterror, אבל גם להוסיף event listener לאירוע gmp-error, שמחזיר אובייקט Event.

הערה: התכונה זמינה רק בערוץ v=beta.

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

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

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

‫PlaceContextualElement class

google.maps.places.PlaceContextualElement class

הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha).

ווידג'ט שמשתמש באסימון ההקשר כדי להציג תצוגה הקשרית של התשובה של 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]) פרמטרים:  options:  PlaceContextualElementOptions optional

מאפיינים
contextToken	סוג:  string optional טוקן ההקשר. מאפיין HTML: <gmp-place-contextual context-token="string"></gmp-place-contextual>

Methods
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 ממשק

הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha).

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

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

‫PlaceContextualListConfigElement class

google.maps.places.PlaceContextualListConfigElement class

הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha).

רכיב 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]) פרמטרים:  options:  PlaceContextualListConfigElementOptions optional

מאפיינים
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>

Methods
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 ממשק

הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha).

אפשרויות ל-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

הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha).

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

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

Constants
COMPACT	פריסת רשימה קומפקטית: פריטי הרשימה מוצגים כקישורים בשורה אחת, והפריטים שחורגים מהשורה מוצגים ברשימה נפתחת.
VERTICAL	פריסה של רשימה אנכית: פריטי הרשימה מוצגים ככרטיסים ברשימה אנכית.

PlaceContextualListMapMode constants

google.maps.places.PlaceContextualListMapMode constants

הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha).

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

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

Constants
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]) פרמטרים:  options:  PlaceDetailsElementOptions optional

מאפיינים
place	סוג:  Place optional קריאה בלבד. אובייקט של מקום שמכיל את המזהה, המיקום ואזור התצוגה של המקום שמוצג כרגע.

מאפייני CSS
--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.

Methods
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) ארגומנטים:  event:  Event האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.
gmp-load	function(event) ארגומנטים:  event:  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]) פרמטרים:  options:  PlaceDetailsCompactElementOptions optional

מאפיינים
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>

מאפייני CSS
--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.

Methods
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) ארגומנטים:  event:  Event האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.
gmp-load	function(event) ארגומנטים:  event:  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.

Constants
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]) פרמטרים:  options:  PlaceDetailsPlaceRequestElementOptions optional

מאפיינים
place	סוג:  Place optional ברירת מחדל: null האובייקט, המזהה או שם המשאב של המקום שרוצים להציג את הפרטים שלו ברכיב Place Details Compact. הערך של המאפיין הזה הוא שם משאב. מאפיין HTML: <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Methods
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]) פרמטרים:  options:  PlaceDetailsLocationRequestElementOptions optional

מאפיינים
location	סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional ברירת מחדל: null המיקום שפרטיו יוצגו ברכיב Place Details. הפונקציה מבצעת נרמול ל-LatLngAltitude. מאפיין HTML: <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

Methods
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	סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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]) פרמטרים:  options:  PlaceSearchElementOptions optional

מאפיינים
attributionPosition	סוג:  PlaceSearchAttributionPosition optional ברירת מחדל: 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>

מאפייני CSS
--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.

Methods
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) ארגומנטים:  event:  Event האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.
gmp-load	function(event) ארגומנטים:  event:  Event האירוע הזה מופעל כשהרכיב נטען והתוכן שלו מוצג. האירוע הזה לא מתפשט.
gmp-select	function(event) ארגומנטים:  event:  PlaceSelectEvent האירוע הזה מופעל כשבוחרים מקום מהרשימה. מכיל אובייקט Place שמכיל את המזהה, המיקום ואזור התצוגה של המקום שנבחר.

‫PlaceSearchElementOptions interface

google.maps.places.PlaceSearchElementOptions ממשק

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

מאפיינים
attributionPosition optional	סוג:  PlaceSearchAttributionPosition 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.

Constants
BOTTOM	שיוך בתחתית של PlaceSearchElement
TOP	שיוך בחלק העליון של PlaceSearchElement

PlaceSearchOrientation קבועים

google.maps.places.PlaceSearchOrientation constants

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

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

Constants
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]) פרמטרים:  options:  PlaceNearbySearchRequestElementOptions optional

מאפיינים
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>

Methods
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]) פרמטרים:  options:  PlaceTextSearchRequestElementOptions optional

מאפיינים
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	סוג:  string|LatLngAltitude|LatLngBounds|Circle|LatLng|LatLngLiteral|LatLngAltitudeLiteral|LatLngBoundsLiteral|CircleLiteral optional ברירת מחדל: 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	סוג:  LatLngBounds|LatLngBoundsLiteral optional ברירת מחדל: 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>

Methods
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	סוג:  string|LatLngAltitude|LatLngBounds|Circle|LatLng|LatLngLiteral|LatLngAltitudeLiteral|LatLngBoundsLiteral|CircleLiteral optional הטיה לפי מיקום בחיפוש. פרטים נוספים מופיעים במאמרים SearchByTextRequest.locationBias וPlaceTextSearchRequestElement.locationBias.
locationRestriction optional	סוג:  LatLngBounds|LatLngBoundsLiteral optional הגבלת מיקום לחיפוש. פרטים נוספים מופיעים במאמרים SearchByTextRequest.locationRestriction וPlaceTextSearchRequestElement.locationRestriction.
maxResultCount optional	סוג:  number optional המספר המקסימלי של תוצאות שיוחזרו. פרטים נוספים מופיעים במאמרים SearchByTextRequest.maxResultCount וPlaceTextSearchRequestElement.maxResultCount.
minRating optional	סוג:  number optional סינון התוצאות כך שיוצגו רק תוצאות שבהן דירוג המשתמשים הממוצע גדול מהמגבלה הזו. פרטים נוספים מופיעים במאמרים SearchByTextRequest.minRating וPlaceTextSearchRequestElement.minRating.
priceLevels optional	סוג:  Array<PriceLevel> optional הפרמטר משמש להגבלת החיפוש למקומות שמסומנים ברמות מחיר מסוימות. פרטים נוספים מופיעים במאמרים SearchByTextRequest.priceLevels וPlaceTextSearchRequestElement.priceLevels.
rankPreference optional	סוג:  SearchByTextRankPreference optional איך התוצאות ידורגו בתשובה. פרטים נוספים מופיעים במאמרים SearchByTextRequest.rankPreference וPlaceTextSearchRequestElement.rankPreference.
textQuery optional	סוג:  string optional שאילתת הטקסט לחיפוש טקסטואלי. פרטים נוספים מופיעים במאמרים SearchByTextRequest.textQuery וPlaceTextSearchRequestElement.textQuery.
useStrictTypeFiltering optional	סוג:  boolean optional הפרמטר הזה משמש להגדרת סינון קפדני של סוגים עבור SearchByTextRequest.includedType. פרטים נוספים מופיעים במאמרים SearchByTextRequest.useStrictTypeFiltering וPlaceTextSearchRequestElement.useStrictTypeFiltering.

‫Autocomplete class

google.maps.places.Autocomplete class

הוצאה משימוש: החל מ-1 במרץ 2025, הכלי google.maps.places.Autocomplete לא יהיה זמין ללקוחות חדשים. יש להשתמש בעמודות PlaceAutocompleteElement במקומן. בשלב הזה, אין תוכניות להוציא משימוש את google.maps.places.Autocomplete, אבל מומלץ להשתמש ב-PlaceAutocompleteElement במקום ב-google.maps.places.Autocomplete. הפונקציה google.maps.places.Autocomplete תמשיך לקבל תיקוני באגים לכל רגרסיה משמעותית, אבל באגים קיימים בפונקציה הזו לא יטופלו. נודיע לכם לפחות 12 חודשים לפני הפסקת התמיכה. פרטים נוספים זמינים בכתובת https://developers.google.com/maps/legacy ומדריך ההעברה זמין בכתובת https://developers.google.com/maps/documentation/javascript/places-migration-overview.

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

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

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

יצרן
Autocomplete	Autocomplete(inputField[, opts]) פרמטרים:  inputField:  HTMLInputElement שדה הטקסט <input> שאליו צריך לצרף את Autocomplete. opts:  AutocompleteOptions optional אפשרויות. הפונקציה יוצרת מופע חדש של Autocomplete שמצורף לשדה הטקסט של הקלט שצוין עם האפשרויות שניתנו.

Methods
getBounds	getBounds() פרמטרים:  אין ערך ההחזרה:  LatLngBounds|undefined הגבולות של הטיית התוצאה. הפונקציה מחזירה את הגבולות שבהם ההטיות של התחזיות מתרחשות.
getFields	getFields() פרמטרים:  אין ערך מוחזר:  Array<string>|undefined הפונקציה מחזירה את השדות שצריך לכלול בתגובה עם הפרטים של המקום, אם הפרטים נשלפו בהצלחה. רשימת השדות זמינה בכתובת PlaceResult.
getPlace	getPlace() פרמטרים:  אין ערך ההחזרה:  PlaceResult המקום שנבחר על ידי המשתמש. מחזירה את פרטי המקום שנבחר על ידי המשתמש אם הפרטים אוחזרו בהצלחה. אחרת, הפונקציה מחזירה אובייקט Place מסוג stub, כשהמאפיין name מוגדר לערך הנוכחי של שדה הקלט.
setBounds	setBounds(bounds) פרמטרים:  ‫bounds:  LatLngBounds|LatLngBoundsLiteral optional הגבולות של ההטיה. ערך מוחזר:  אין הגדרת האזור המועדף שבו יוחזרו תוצאות של מקומות. התוצאות מוטות לכיוון האזור הזה, אבל לא מוגבלות אליו.
setComponentRestrictions	setComponentRestrictions(restrictions) פרמטרים:  ‫restrictions:  ComponentRestrictions optional ההגבלות על השימוש. ערך מוחזר:  אין הגדרת ההגבלות על הרכיב. הגבלות על רכיבים משמשות להגבלת התחזיות רק לאלה שנמצאות ברכיב האב. לדוגמה, המדינה.
setFields	setFields(fields) פרמטרים:  fields:  Array<string> optional ערך מוחזר:  אין מגדיר את השדות שייכללו בתשובת הפרטים לגבי המקום, כשהפרטים מאוחזרים בהצלחה. רשימת השדות זמינה בכתובת PlaceResult.
setOptions	setOptions(options) פרמטרים:  options:  AutocompleteOptions optional ערך מוחזר:  אין
setTypes	setTypes(types) פרמטרים:  ‫types:  Array<string> optional סוגי התחזיות שרוצים לכלול. ערך מוחזר:  אין הגדרת סוגי התחזיות שיוחזרו. ב מדריך למפתחים מפורטים הסוגים הנתמכים. אם לא מציינים סוגים, כל הסוגים יוחזרו.
בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

אירועים
place_changed	function() ארגומנטים:  אין האירוע הזה מופעל כשמקום PlaceResult הופך לזמין עבור מקום שהמשתמש בחר. אם המשתמש מזין שם של מקום שלא הוצע על ידי הרכיב ולוחץ על מקש Enter, או אם בקשה לפרטי מקום נכשלת, האובייקט PlaceResult מכיל את קלט המשתמש במאפיין name, ללא מאפיינים אחרים.

ממשק AutocompleteOptions

google.maps.places.AutocompleteOptions ממשק

האפשרויות שאפשר להגדיר באובייקט Autocomplete.

מאפיינים
bounds optional	סוג:  LatLngBounds|LatLngBoundsLiteral optional האזור שבו יתבצע חיפוש המקומות.
componentRestrictions optional	סוג:  ComponentRestrictions optional הגבלות על הרכיב. הגבלות על רכיבים משמשות להגבלת התחזיות רק לאלה שנמצאות ברכיב האב. לדוגמה, המדינה.
fields optional	סוג:  Array<string> optional השדות שייכללו בתגובת הפרטים לגבי המקום, אם הפרטים אוחזרו בהצלחה, שעליהם יחויב. אם מעבירים את הערך ['ALL'], כל השדות הזמינים יוחזרו ותחויבו עליהם (לא מומלץ להשתמש באפשרות הזו בפריסות של מוצרים). רשימת השדות זמינה בכתובת PlaceResult. אפשר לציין שדות מקוננים באמצעות נתיבי נקודה (לדוגמה, "geometry.location"). ברירת המחדל היא ['ALL'].
placeIdOnly optional	הוצאה משימוש: placeIdOnly הוצאה משימוש ב-15 בינואר 2019, והיא תושבת ב-15 בינואר 2020. במקום זאת, צריך להשתמש ב-AutocompleteOptions.fields: fields: ['place_id', 'name', 'types']. סוג:  boolean optional אם לאחזר רק מזהי מקומות. האובייקט PlaceResult שזמין כשמופעל האירוע place_changed יכלול רק את השדות place_id, ‏ types ו-name, עם הערכים place_id, ‏ types ו-description שמוחזרים על ידי שירות ההשלמה האוטומטית. מושבת כברירת מחדל.
strictBounds optional	סוג:  boolean optional ערך בוליאני שמציין שווידג'ט ההשלמה האוטומטית צריך להחזיר רק את המקומות שנמצאים בתוך הגבולות של הווידג'ט בזמן שליחת השאילתה. הגדרה של strictBounds לערך false (שהוא ברירת המחדל) תגרום להטיה של התוצאות למקומות שנכללים בגבולות, אבל לא תגביל אותן רק למקומות האלה.
types optional	סוג:  Array<string> optional סוגי החיזויים שיוחזרו. ב מדריך למפתחים מפורטים הסוגים הנתמכים. אם לא מציינים סוגים, כל הסוגים יוחזרו.

‫SearchBox class

google.maps.places.SearchBox class

הוצאה משימוש: החל מ-1 במרץ 2025, הכלי google.maps.places.SearchBox לא יהיה זמין ללקוחות חדשים. בשלב הזה, אין תוכניות להוציא משימוש את google.maps.places.SearchBox, והוא ימשיך לקבל תיקוני באגים לכל רגרסיה משמעותית. נודיע לכם לפחות 12 חודשים לפני הפסקת התמיכה. פרטים נוספים זמינים בכתובת https://developers.google.com/maps/legacy.

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

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

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

יצרן
SearchBox	SearchBox(inputField[, opts]) פרמטרים:  inputField:  HTMLInputElement opts:  SearchBoxOptions optional הפונקציה יוצרת מופע חדש של SearchBox שמצורף לשדה הטקסט של הקלט שצוין עם האפשרויות שניתנו.

Methods
getBounds	getBounds() פרמטרים:  אין ערך מוחזר:  LatLngBounds|undefined מחזירה את הגבולות שבהם תחזיות השאילתות מוטות.
getPlaces	getPlaces() פרמטרים:  אין ערך מוחזר:  Array<PlaceResult>|undefined מחזירה את השאילתה שהמשתמש בחר לשימוש עם אירוע places_changed.
setBounds	setBounds(bounds) פרמטרים:  bounds:  LatLngBounds|LatLngBoundsLiteral optional ערך מוחזר:  אין הגדרת האזור שמשמש להטיית התחזיות של השאילתות. התוצאות יהיו מוטות לאזור הזה בלבד, ולא יוגבלו אליו באופן מלא.
בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

אירועים
places_changed	function() ארגומנטים:  אין האירוע הזה מופעל כשהמשתמש בוחר שאילתה. צריך להשתמש ב-getPlaces כדי לקבל מקומות חדשים.

‫SearchBoxOptions interface

google.maps.places.SearchBoxOptions ממשק

האפשרויות שאפשר להגדיר באובייקט SearchBox.

מאפיינים
bounds optional	סוג:  LatLngBounds|LatLngBoundsLiteral optional האזור שלפיו יוטו תחזיות השאילתות. התחזיות מוטות לטובת שאילתות שמטרגטות את הגבולות האלה, אבל לא מוגבלות אליהן.