Places Widgets

‫PlaceAutocompleteElement class

google.maps.places.PlaceAutocompleteElement class

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

מאפיינים
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|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|imperial"></gmp-place-autocomplete>
componentRestrictions	סוג:  ComponentRestrictions optional הגבלות על הרכיב. הגבלות על רכיבים משמשות להגבלת התחזיות רק לאלה שנמצאות ברכיב האב. לדוגמה, המדינה.
types	סוג:  Array<string> optional סוגי החיזויים שיוחזרו. ב מדריך למפתחים מפורטים הסוגים הנתמכים. אם לא מציינים סוגים, כל הסוגים יוחזרו. מאפיין HTML: <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>

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.

‫PlaceAutocompleteElementOptions interface

google.maps.places.PlaceAutocompleteElementOptions ממשק

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

מאפיינים
componentRestrictions optional	סוג:  ComponentRestrictions optional
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
types optional	סוג:  Array<string> optional
unitSystem optional	סוג:  UnitSystem optional

‫PlaceAutocompletePlaceSelectEvent class

google.maps.places.PlaceAutocompletePlaceSelectEvent class

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

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

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

מאפיינים
place	סוג:  Place

‪PlacePredictionSelectEvent class

google.maps.places.PlacePredictionSelectEvent class

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

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

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

‫PlaceAutocompleteRequestErrorEvent class

google.maps.places.PlaceAutocompleteRequestErrorEvent class

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

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

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

‫PlaceDetailsElement class

google.maps.places.PlaceDetailsElement class

רכיב 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.

Methods
addEventListener	addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת שרגישה לאותיות רישיות ומייצגת את סוג האירוע להאזנה. ‫listener:  EventListener|