Places Widgets

‫PlaceAutocompleteElement class

google.maps.places.PlaceAutocompleteElement class

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

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

רכיב בהתאמה אישית:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng|lat,lng,altitude" requested-language="string" requested-region="string" unit-system="metric|imperial" types="type1 type2 type3..."></gmp-place-autocomplete>

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

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

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

יצרן
PlaceAutocompleteElement	PlaceAutocompleteElement(options) פרמטרים:  options:  PlaceAutocompleteElementOptions

מאפיינים
includedPrimaryTypes	הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha). סוג:  Array<string> optional סוג המקום הראשי שכלול (לדוגמה, 'מסעדה' או 'תחנת דלק'). מקום יוחזר רק אם הסוג הראשי שלו כלול ברשימה הזו. אפשר לציין עד 5 ערכים. אם לא מציינים סוגים, כל סוגי המקומות מוחזרים. מאפיין HTML: <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes	הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha). סוג:  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	הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha). סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional נקודת המוצא שממנה יחושב המרחק. אם לא מציינים את המרחק, הוא לא מחושב. אם הגובה מצוין, הוא לא משמש לחישוב. מאפיין HTML: <gmp-place-autocomplete origin="lat,lng|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	הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha). סוג:  UnitSystem optional מערכת היחידות שמשמשת להצגת מרחקים. אם לא מציינים את מערכת היחידות, היא נקבעת לפי requestedRegion. מאפיין HTML: <gmp-place-autocomplete unit-system="metric|imperial"></gmp-place-autocomplete>
componentRestrictions	הוצא משימוש: הנכס הזה ימשיך לפעול בערוץ הבטא, אבל הוא לא יהיה זמין בגרסת אלפא או בגרסה הסופית. למטרות העברה (מיגרציה), צריך לציין גם את המאפיין הזה וגם את המאפיין includeRegionCodes. הערה: התכונה זמינה רק בערוץ v=beta. סוג:  ComponentRestrictions optional הגבלות על הרכיב. הגבלות על רכיבים משמשות להגבלת התחזיות רק לאלה שנמצאות ברכיב האב. לדוגמה, המדינה.
types	הוצא משימוש: הנכס הזה ימשיך לפעול בערוץ הבטא, אבל הוא לא יהיה זמין בגרסת אלפא או בגרסה הסופית. למטרות העברה (מיגרציה), צריך לציין גם את המאפיין הזה וגם את המאפיין includedPrimaryTypes. הערה: התכונה זמינה רק בערוץ v=beta. סוג:  Array<string> optional סוגי החיזויים שיוחזרו. ב מדריך למפתחים מפורטים הסוגים הנתמכים. אם לא מציינים סוגים, כל הסוגים יוחזרו. מאפיין HTML: <gmp-place-autocomplete types="type1 type2 type3..."></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.
gmp-placeselect	הוצא משימוש: האירוע gmp-placeselect ימשיך להיות מופעל בערוץ הבטא, אבל לא יופעל בערוץ אלפא או בגרסה הסופית. לצורך העברה, צריך להמשיך להאזין לאירוע gmp-placeselect, אבל גם להוסיף event listener לאירוע gmp-select, שמחזיר אובייקט PlacePredictionSelectEvent. function(placeAutocompletePlaceSelectEvent) ארגומנטים:  placeAutocompletePlaceSelectEvent:  PlaceAutocompletePlaceSelectEvent האירוע הזה מופעל כשמשתמש בוחר תחזית של מקום. מכיל אובייקט Place.

‫PlaceAutocompleteElementOptions interface

google.maps.places.PlaceAutocompleteElementOptions ממשק

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

אפשרויות ליצירת PlaceAutocompleteElement. לתיאור של כל נכס, אפשר לעיין בנכס עם אותו שם במחלקה PlaceAutocompleteElement.

מאפיינים
componentRestrictions optional	הוצא משימוש: הנכס הזה ימשיך לפעול בערוץ הבטא, אבל הוא לא יהיה זמין בגרסת אלפא או בגרסה הסופית. למטרות העברה (מיגרציה), צריך לציין גם את המאפיין הזה וגם את המאפיין includedRegionCodes. הערה: התכונה זמינה רק בערוץ v=beta. סוג:  ComponentRestrictions optional
includedPrimaryTypes optional	הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha). סוג:  Array<string> optional
includedRegionCodes optional	הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha). סוג:  Array<string> optional
locationBias optional	סוג:  LocationBias optional
locationRestriction optional	סוג:  LocationRestriction optional
name optional	סוג:  string optional
origin optional	הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha). סוג:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
requestedLanguage optional	סוג:  string optional
types optional	הוצא משימוש: הנכס הזה ימשיך לפעול בערוץ הבטא, אבל הוא לא יהיה זמין בגרסת אלפא או בגרסה הסופית. למטרות העברה (מיגרציה), צריך לציין גם את המאפיין הזה וגם את המאפיין includedPrimaryTypes. הערה: התכונה זמינה רק בערוץ v=beta. סוג:  Array<string> optional
unitSystem optional	הערה: התכונה הזו זמינה רק בערוץ אלפא (v=alpha). סוג:  UnitSystem optional

‫PlaceAutocompletePlaceSelectEvent class

google.maps.places.PlaceAutocompletePlaceSelectEvent class

הוצא משימוש: האירוע gmp-placeselect ימשיך להיות מופעל בערוץ הבטא, אבל לא יופעל בערוץ אלפא או בגרסה הסופית. לצורך העברה, צריך להמשיך להאזין לאירוע gmp-placeselect, אבל גם להוסיף event listener לאירוע gmp-select, שמחזיר אובייקט PlacePredictionSelectEvent.

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

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

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

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

מאפיינים
place	הערה: התכונה זמינה רק בערוץ v=beta. סוג:  Place

‪PlacePredictionSelectEvent class

google.maps.places.PlacePredictionSelectEvent class

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

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

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

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

מאפיינים
placePrediction	סוג:  PlacePrediction

‫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.

‫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	גרסה גדולה במיוחד שכוללת קולאז' תמונות, ביקורות ומידע מקיף על המקום.

‫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

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

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