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

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. 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.

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

הוצא משימוש: האירוע 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.

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

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

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

במחלקה הזו מיושם PlaceContextualListConfigElementOptions.

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

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

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. 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).

PlaceContextualListLayout constants

google.maps.places.PlaceContextualListLayout constants

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

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

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

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

‫PlaceDetailsElement class

google.maps.places.PlaceDetailsElement class

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

רכיב HTML שמציג פרטים על מקום. משתמשים בשיטות configureFromPlace() או configureFromLocation() כדי לציין את התוכן שיוצג. כדי להשתמש ברכיב Place Details (פרטי מקום), צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

רכיב בהתאמה אישית:
<gmp-place-details size="small"></gmp-place-details>

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

במחלקה הזו מיושם PlaceDetailsElementOptions.

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

יצרן
PlaceDetailsElement	PlaceDetailsElement([options]) פרמטרים:  options:  PlaceDetailsElementOptions optional

מאפיינים
place	סוג:  Place optional קריאה בלבד. אובייקט Place שמכיל את המזהה, המיקום ואזור התצוגה של המקום שמוצג כרגע.
size	סוג:  PlaceDetailsSize optional הווריאציה של המידה של PlaceDetailsElement. כברירת מחדל, האלמנט יציג את הסמל PlaceDetailsSize.X_LARGE. מאפיין HTML: <gmp-place-details size="small"></gmp-place-details> <gmp-place-details size="medium"></gmp-place-details> <gmp-place-details size="large"></gmp-place-details> <gmp-place-details size="x-large"></gmp-place-details>

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
configureFromLocation	configureFromLocation(location) פרמטרים:  ‫location:  LatLng|LatLngLiteral המיקום שבו יוצגו פרטי המקום. ערך ההחזרה:  Promise<void> הבטחה שמושלמת אחרי שנתוני המקום נטענים ומוצגים. הגדרת הווידג'ט מתוך LatLng באמצעות מיקום גיאוגרפי הפוך.
configureFromPlace	configureFromPlace(place) פרמטרים:  ‫place:  Place|{id:string} המקום שבו יוצגו הפרטים. ערך ההחזרה:  Promise<void> הבטחה שמושלמת אחרי שנתוני המקום נטענים ומוצגים. הגדרת הווידג'ט מאובייקט Place או ממזהה מקום.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

אירועים
gmp-load	function(event) ארגומנטים:  event:  Event האירוע הזה מופעל כשהרכיב נטען והתוכן שלו מוצג. האירוע הזה לא מתפשט.
gmp-requesterror	function(event) ארגומנטים:  event:  Event האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.

‫PlaceDetailsElementOptions interface

google.maps.places.PlaceDetailsElementOptions ממשק

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

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

מאפיינים
size optional	סוג:  PlaceDetailsSize optional הצגה של PlaceDetailsElement.size

PlaceDetailsSize constants

google.maps.places.PlaceDetailsSize constants

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

וריאציות של גודל עבור PlaceDetailsElement.

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

Constants
LARGE	וריאציה גדולה שכוללת תמונה גדולה, מידע בסיסי ופרטים ליצירת קשר.
MEDIUM	וריאציה בינונית שכוללת תמונה גדולה ומידע בסיסי.
SMALL	גרסה קטנה שכוללת תמונה קטנה ומידע בסיסי.
X_LARGE	גרסה גדולה במיוחד שכוללת קולאז' תמונות, ביקורות ומידע מקיף על המקום.

‫PlaceDetailsCompactElement class

google.maps.places.PlaceDetailsCompactElement class

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

הצגת פרטים על מקום מסוים בפריסה קומפקטית. מוסיפים PlaceDetailsPlaceRequestElement כדי לציין את המקום שיוצג. מוסיפים PlaceContentConfigElement, PlaceStandardContentElement או PlaceAllContentElement כדי לציין איזה תוכן להציג.

כדי להשתמש ברכיב הזה, צריך להפעיל את 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-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	הצבע של הטקסט והסמלים האינטראקטיביים ביחס לצבע המשטח. המשתנה הזה משמש לספירת הביקורות ולקישורים בתיבת הדו-שיח של השיוך.
--gmp-mat-color-secondary-container	צבע המילוי פחות בולט על פני השטח, ברכיבים נסוגים כמו כפתורים בצבע אחד. הצבע הזה משמש לרקע של הלחצן 'פתיחה במפות'.
--gmp-mat-color-surface	צבע לרקעים. משמש לרקעים של הרכיב ושל תיבת הדו-שיח של השיוך (Attribution).
--gmp-mat-font-body-medium	משמש לטקסט בגוף תיבת הדו-שיח של השיוך.
--gmp-mat-font-body-small	הנתונים האלה משמשים לציון הכתובת, הדירוג, הסוג, המחיר והסטטוס 'פתוח כרגע' של המקום.
--gmp-mat-font-family	משפחת הגופנים הבסיסית שמשמשת לכל הטקסט.
--gmp-mat-font-headline-medium	משמש לטקסט של כותרת בתיבת הדו-שיח של השיוך.
--gmp-mat-font-label-large	הפרמטר הזה משמש ללחצן 'פתיחה במפות Google' ולקישורים בתיבת הדו-שיח של השיוך.
--gmp-mat-font-title-small	השם של המקום.
background-color	הגדרה שמשנה את צבע הרקע של הרכיב.
border	הגדרה שמשנה את הגבול של הרכיב.
border-radius	המאפיין מחליף את רדיוס הגבולות של האלמנט.
color-scheme	מציין את העיצוב שבו אפשר להציג את הרכיב הזה. פרטים נוספים זמינים בcolor-scheme מאמרי העזרה. ברירת המחדל היא color-scheme: light dark.
font-size	הפונקציה משנה את הגודל של כל הטקסט והסמלים ברכיב, שמוגדרים באופן פנימי ביחידות em. ברירת המחדל היא 16px.

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. 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 ממשק

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

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

מאפיינים
orientation optional	סוג:  PlaceDetailsOrientation optional PlaceDetailsCompactElement.orientation.
truncationPreferred optional	סוג:  boolean optional PlaceDetailsCompactElement.truncationPreferred.

PlaceDetailsOrientation constants

google.maps.places.PlaceDetailsOrientation constants

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

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

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

Constants
HORIZONTAL	כיוון אופקי.
VERTICAL	כיוון אנכי.

‫PlaceDetailsPlaceRequestElement class

google.maps.places.PlaceDetailsPlaceRequestElement class

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

מגדיר אלמנט Place Details Compact לטעינת נתונים על סמך אובייקט של מקום, מזהה או שם משאב. מוסיפים את הרכיב הזה כרכיב צאצא של PlaceDetailsCompactElement כדי לטעון נתונים של המקום שצוין.

רכיב בהתאמה אישית:
<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 האובייקט, המזהה או שם המשאב של המקום שרוצים להציג את הפרטים שלו ברכיב Place Details Compact. הערך של המאפיין הזה הוא שם משאב. מאפיין HTML: <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. 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 ממשק

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

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

מאפיינים
place optional	סוג:  Place|string optional הצגה של PlaceDetailsPlaceRequestElement.place

‫PlaceContentConfigElement class

google.maps.places.PlaceContentConfigElement class

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

הגדרת התוכן שיוצג על ידי רכיב Place Details Compact. כדי להשתמש ברכיב הזה, צריך להוסיף אותו כרכיב צאצא של PlaceDetailsCompactElement. מוסיפים את אחד מהרכיבים הבאים לרכיב PlaceContentConfigElement כדי להציג את התוכן המתאים:
PlaceMediaElement, ‏ PlaceAddressElement, ‏ PlaceRatingElement, ‏ PlaceTypeElement, ‏ PlacePriceElement, ‏ PlaceAccessibleEntranceIconElement, ‏ PlaceOpenNowStatusElement, ‏ PlaceAttributionElement
אין חשיבות לסדר של רכיבי הצאצא. התוכן מוצג בסדר רגיל שלא ניתן להתאים אישית.

רכיב בהתאמה אישית:
<gmp-place-content-config></gmp-place-content-config>

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

במחלקה הזו מיושם PlaceContentConfigElementOptions.

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

יצרן
PlaceContentConfigElement	PlaceContentConfigElement([options]) פרמטרים:  options:  PlaceContentConfigElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

ממשק PlaceContentConfigElementOptions

google.maps.places.PlaceContentConfigElementOptions ממשק

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

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

PlaceMediaElement class

google.maps.places.PlaceMediaElement class

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

הגדרת רכיב Place Details Compact (פרטים קומפקטיים של מקום) להצגת מדיה של מקום, כמו תמונות. כדי להשתמש ברכיב הזה, צריך להוסיף אותו כרכיב צאצא של PlaceContentConfigElement.

רכיב בהתאמה אישית:
<gmp-place-media lightbox-preferred></gmp-place-media>

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

במחלקה הזו מיושם PlaceMediaElementOptions.

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

יצרן
PlaceMediaElement	PlaceMediaElement([options]) פרמטרים:  options:  PlaceMediaElementOptions optional

מאפיינים
lightboxPreferred	סוג:  boolean optional ברירת מחדל: false האם להפעיל או להשבית את תיבת הדו-שיח של המדיה, במקרים שבהם שתי האפשרויות נתמכות. מאפיין HTML: <gmp-place-media lightbox-preferred></gmp-place-media>

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

PlaceMediaElementOptions interface

google.maps.places.PlaceMediaElementOptions ממשק

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

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

מאפיינים
lightboxPreferred optional	סוג:  boolean optional PlaceMediaElement.lightboxPreferred.

‫PlaceAddressElement class

google.maps.places.PlaceAddressElement class

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

הגדרת אלמנט Place Details Compact להצגת הכתובת של מקום. כדי להשתמש ברכיב הזה, צריך להוסיף אותו כרכיב צאצא של PlaceContentConfigElement.

רכיב בהתאמה אישית:
<gmp-place-address></gmp-place-address>

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

במחלקה הזו מיושם PlaceAddressElementOptions.

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

יצרן
PlaceAddressElement	PlaceAddressElement([options]) פרמטרים:  options:  PlaceAddressElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PlaceAddressElementOptions interface

google.maps.places.PlaceAddressElementOptions ממשק

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

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

‫PlaceRatingElement class

google.maps.places.PlaceRatingElement class

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

מגדיר אלמנט Place Details Compact כדי להציג את דירוג המקום. כדי להשתמש ברכיב הזה, צריך להוסיף אותו כרכיב צאצא של PlaceContentConfigElement.

רכיב בהתאמה אישית:
<gmp-place-rating></gmp-place-rating>

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

במחלקה הזו מיושם PlaceRatingElementOptions.

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

יצרן
PlaceRatingElement	PlaceRatingElement([options]) פרמטרים:  options:  PlaceRatingElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PlaceRatingElementOptions interface

google.maps.places.PlaceRatingElementOptions ממשק

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

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

PlaceTypeElement class

google.maps.places.PlaceTypeElement class

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

ההגדרה קובעת שרכיב Place Details Compact יציג את סוג המקום. כדי להשתמש ברכיב הזה, צריך להוסיף אותו כרכיב צאצא של PlaceContentConfigElement.

רכיב בהתאמה אישית:
<gmp-place-type></gmp-place-type>

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

במחלקה הזו מיושם PlaceTypeElementOptions.

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

יצרן
PlaceTypeElement	PlaceTypeElement([options]) פרמטרים:  options:  PlaceTypeElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PlaceTypeElementOptions interface

google.maps.places.PlaceTypeElementOptions ממשק

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

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

‫PlacePriceElement class

google.maps.places.PlacePriceElement class

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

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

רכיב בהתאמה אישית:
<gmp-place-price></gmp-place-price>

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

במחלקה הזו מיושם PlacePriceElementOptions.

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

יצרן
PlacePriceElement	PlacePriceElement([options]) פרמטרים:  options:  PlacePriceElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PlacePriceElementOptions interface

google.maps.places.PlacePriceElementOptions ממשק

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

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

PlaceAccessibleEntranceIconElement class

google.maps.places.PlaceAccessibleEntranceIconElement class

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

הגדרת רכיב Place Details Compact להצגת סמל של כיסא גלגלים אם למקום יש כניסה נגישה. כדי להשתמש ברכיב הזה, צריך להוסיף אותו כרכיב צאצא של PlaceContentConfigElement.

רכיב בהתאמה אישית:
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>

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

במחלקה הזו מיושם PlaceAccessibleEntranceIconElementOptions.

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

יצרן
PlaceAccessibleEntranceIconElement	PlaceAccessibleEntranceIconElement([options]) פרמטרים:  options:  PlaceAccessibleEntranceIconElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

PlaceAccessibleEntranceIconElementOptions interface

google.maps.places.PlaceAccessibleEntranceIconElementOptions ממשק

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

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

‫PlaceOpenNowStatusElement class

google.maps.places.PlaceOpenNowStatusElement class

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

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

רכיב בהתאמה אישית:
<gmp-place-open-now-status></gmp-place-open-now-status>

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

במחלקה הזו מיושם PlaceOpenNowStatusElementOptions.

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

יצרן
PlaceOpenNowStatusElement	PlaceOpenNowStatusElement([options]) פרמטרים:  options:  PlaceOpenNowStatusElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PlaceOpenNowStatusElementOptions interface

google.maps.places.PlaceOpenNowStatusElementOptions ממשק

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

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

‫PlaceAttributionElement class

google.maps.places.PlaceAttributionElement class

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

מאפשר התאמה אישית של טקסט השיוך של מפות Google ברכיב Place Details Compact. כדי להשתמש ברכיב הזה, צריך להוסיף אותו כרכיב צאצא של PlaceContentConfigElement. אם משמיטים את הרכיב הזה, הקרדיט עדיין יוצג עם צבעי ברירת המחדל.

רכיב בהתאמה אישית:
<gmp-place-attribution dark-scheme-color="white" light-scheme-color="white"></gmp-place-attribution>

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

במחלקה הזו מיושם PlaceAttributionElementOptions.

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

יצרן
PlaceAttributionElement	PlaceAttributionElement([options]) פרמטרים:  options:  PlaceAttributionElementOptions optional

מאפיינים
darkSchemeColor	סוג:  AttributionColor optional ברירת מחדל: AttributionColor.WHITE הצבע של השיוך במפות Google במצב כהה. מאפיין HTML: <gmp-place-attribution dark-scheme-color="white"></gmp-place-attribution> <gmp-place-attribution dark-scheme-color="black"></gmp-place-attribution> <gmp-place-attribution dark-scheme-color="gray"></gmp-place-attribution>
lightSchemeColor	סוג:  AttributionColor optional ברירת מחדל: AttributionColor.GRAY הצבע של השיוך במפות Google במצב בהיר. מאפיין HTML: <gmp-place-attribution light-scheme-color="white"></gmp-place-attribution> <gmp-place-attribution light-scheme-color="black"></gmp-place-attribution> <gmp-place-attribution light-scheme-color="gray"></gmp-place-attribution>

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PlaceAttributionElementOptions interface

google.maps.places.PlaceAttributionElementOptions ממשק

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

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

מאפיינים
darkSchemeColor optional	סוג:  AttributionColor optional PlaceAttributionElement.darkSchemeColor.
lightSchemeColor optional	סוג:  AttributionColor optional PlaceAttributionElement.lightSchemeColor.

AttributionColor constants

google.maps.places.AttributionColor constants

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

אפשרויות הצבע של טקסט השיוך במפות Google. אפשר להתאים אישית את השיוך כך שישתמש בכל אחד מהצבעים האלה.

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

Constants
BLACK	טקסט שחור לציון קרדיט.
GRAY	טקסט אפור לציון קרדיט.
WHITE	טקסט לבן של ייחוס.

‫PlaceAllContentElement class

google.maps.places.PlaceAllContentElement class

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

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

רכיב בהתאמה אישית:
<gmp-place-all-content></gmp-place-all-content>

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

במחלקה הזו מיושם PlaceAllContentElementOptions.

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

יצרן
PlaceAllContentElement	PlaceAllContentElement([options]) פרמטרים:  options:  PlaceAllContentElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

‫PlaceAllContentElementOptions interface

google.maps.places.PlaceAllContentElementOptions ממשק

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

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

‫PlaceStandardContentElement class

google.maps.places.PlaceStandardContentElement class

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

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

רכיב בהתאמה אישית:
<gmp-place-standard-content></gmp-place-standard-content>

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

במחלקה הזו מיושם PlaceStandardContentElementOptions.

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

יצרן
PlaceStandardContentElement	PlaceStandardContentElement([options]) פרמטרים:  options:  PlaceStandardContentElementOptions optional

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

ממשק PlaceStandardContentElementOptions

google.maps.places.PlaceStandardContentElementOptions ממשק

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

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

‫PlaceListElement class

google.maps.places.PlaceListElement class

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

רכיב HTML שמציג את תוצאות החיפוש של מקום ברשימה. משתמשים בשיטות configureFromSearchByTextRequest() או configureFromSearchNearbyRequest() כדי לציין את הבקשה להצגת התוצאות. כדי להשתמש ברכיב Place List, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

רכיב בהתאמה אישית:
<gmp-place-list selectable></gmp-place-list>

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

במחלקה הזו מיושם PlaceListElementOptions.

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

יצרן
PlaceListElement	PlaceListElement([options]) פרמטרים:  options:  PlaceListElementOptions optional

מאפיינים
places	סוג:  Array<Place> קריאה בלבד. מערך של אובייקטים מסוג Place שמכילים את המזהים, המיקומים ואזורי התצוגה של המקומות שמוצגים כרגע.
selectable	סוג:  boolean האם אפשר לבחור את הפריטים ברשימה. אם הערך הוא true, הפריטים ברשימה יהיו לחצנים שיפעילו את האירוע gmp-placeselect כשלוחצים עליהם. יש גם תמיכה בבחירה ובניווט במקלדת שמותאמים לנגישות. מאפיין HTML: <gmp-place-list selectable></gmp-place-list>

Methods
addEventListener	הערה: התכונה זמינה רק בערוץ v=beta. addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent options:  boolean|AddEventListenerOptions optional אפשרויות אירועים מותאמים אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדיר פונקציה שתופעל בכל פעם שהאירוע שצוין מועבר ליעד. מידע נוסף זמין בהגדרה של addEventListener.
configureFromSearchByTextRequest	configureFromSearchByTextRequest(request) פרמטרים:  ‫request:  SearchByTextRequest הבקשה להצגת תוצאות. המאפיין fields של SearchByTextRequest הוא לא מאפיין חובה. ערך ההחזרה:  Promise<void> הבטחה שמושלמת אחרי שנתוני המקום נטענים ומוצגים. הגדרת הווידג'ט כך שיוצגו בו תוצאות חיפוש מבקשת Places Text Search API.
configureFromSearchNearbyRequest	configureFromSearchNearbyRequest(request) פרמטרים:  ‫request:  SearchNearbyRequest הבקשה להצגת תוצאות. המאפיין fields של SearchNearbyRequest הוא לא מאפיין חובה. ערך ההחזרה:  Promise<void> הבטחה שמושלמת אחרי שנתוני המקום נטענים ומוצגים. הווידג'ט מוגדר להצגת תוצאות חיפוש מבקשת API של חיפוש מקומות בסביבה.
removeEventListener	הערה: התכונה זמינה רק בערוץ v=beta. removeEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שמציינת את סוג האירוע שלגביו רוצים להסיר את מאזין האירועים. ‫listener:  EventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. options:  boolean|EventListenerOptions optional אפשרויות ערך מוחזר:  void מסירה מהיעד event listener שנרשם קודם באמצעות addEventListener. מידע נוסף זמין במאמר בנושא removeEventListener.

אירועים
gmp-load	function(event) ארגומנטים:  event:  Event האירוע הזה מופעל כשהרכיב נטען והתוכן שלו מוצג. האירוע הזה לא מתפשט.
gmp-placeselect	function(event) ארגומנטים:  event:  PlaceListPlaceSelectEvent האירוע הזה מופעל כשמשתמש בוחר מקום. מכיל אובייקט Place ואת האינדקס של המקום שנבחר ברשימה.
gmp-requesterror	function(event) ארגומנטים:  event:  Event האירוע הזה מופעל כשבקשה לשרת העורפי נדחית (למשל, מפתח API שגוי). האירוע הזה לא מתפשט.

‫PlaceListElementOptions interface

google.maps.places.PlaceListElementOptions ממשק

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

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

מאפיינים
selectable optional	סוג:  boolean optional הצגה של PlaceListElement.selectable

‫PlaceListPlaceSelectEvent class

google.maps.places.PlaceListPlaceSelectEvent class

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

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

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

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

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

‫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 האזור שלפיו יוטו תחזיות השאילתות. התחזיות מוטות לטובת שאילתות שמטרגטות את הגבולות האלה, אבל לא מוגבלות אליהן.