Places Widgets

המחלקה PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement סיווג

הערה: האפשרות הזו זמינה רק בערוץ v=alpha.

• PlaceAutomaticElement היא מחלקת משנה של HTMLElement שמספקת רכיב של ממשק המשתמש להשלמה אוטומטית של מקומות ב-Places API. אחרי שטוענים את ספריית places, ניתן ליצור קלט עם פונקציונליות של השלמה אוטומטית ב-HTML. למשל:

  <gmp-placeautocomplete ></gmp-placeautocomplete>

רכיב מותאם אישית:
<gmp-placeautocomplete></gmp-placeautocomplete>

הכיתה הזו משתרעת על פני HTMLElement.

במחלקה הזו מוטמעת PlaceAutocompleteElementOptions.

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

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

תכונות
inputElement	סוג:  HTMLInputElement רכיב הקלט שעבורו רוצים להציג השלמות אוטומטיות.
עברה בירושה: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types

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

ממשק PlaceAutocompleteElementOptions

ממשק google.maps.places.PlaceAutocompleteElementOptions

הערה: האפשרות הזו זמינה רק בערוץ v=alpha.

אפשרויות לבניית רכיב PlaceAutomaticElement.

תכונות
inputElement	סוג:  HTMLInputElement רכיב הקלט שעבורו רוצים להציג השלמות אוטומטיות.
componentRestrictions optional	סוג:  ComponentRestrictions optional ההגבלות על הרכיבים. הגבלות על רכיבים משמשות להגבלת החיזויים רק לאלו שבתוך רכיב ההורה. למשל, המדינה.
locationBias optional	סוג:  LocationBias optional גבול רך או רמז לשימוש בעת חיפוש מקומות.
locationRestriction optional	סוג:  LocationRestriction optional גבולות להגבלת תוצאות החיפוש.
requestedLanguage optional	סוג:  string optional מזהה השפה של השפה שבה יוצגו התוצאות, אם זה אפשרי. יכול להיות שתוצאות בשפה שנבחרה יקבלו דירוג גבוה יותר, אבל ההצעות לא מוגבלות לשפה הזו. כאן אפשר לעיין ברשימת השפות הנתמכות.
requestedRegion optional	סוג:  string optional קוד אזור המשמש לעיצוב תוצאות ולסינון תוצאות. היא לא מגבילה את ההצעות למדינות האלה. קוד האזור מקבל ערך בן שני תווים של ccTLD ("דומיין ברמה העליונה"). רוב הקודים של ccTLD זהים לקודי ISO 3166-1, למעט כמה יוצאים מן הכלל. לדוגמה, הדומיין ברמה העליונה של קוד מדינה (ccTLD) בבריטניה הוא "uk" (.co.uk) אבל קוד ISO 3166-1 שלו הוא "gb" (טכני עבור הישות "בריטניה וצפון אירלנד").
types optional	סוג:  Array<string> optional סוגי החיזויים שיש להחזיר. הסוגים הנתמכים מפורטים במדריך למפתחים. אם לא מציינים סוגים, כל הסוגים יוחזרו.

שיעור של PlaceAutocompletePlaceSelectEvent

google.maps.places.PlaceAutocompletePlaceSelectEvent סיווג

הערה: האפשרות הזו זמינה רק בערוץ v=alpha.

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

הכיתה הזו משתרעת על פני Event.

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

המחלקה PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent סיווג

הערה: האפשרות הזו זמינה רק בערוץ v=alpha.

האירוע הזה נפלט על ידי ה-PlaceAutomaticElement כשיש בעיה בבקשת הרשת.

הכיתה הזו משתרעת על פני Event.

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

השלמה אוטומטית של הכיתה

google.maps.places.Autocomplete סיווג

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

הכיתה הזו משתרעת על פני MVCObject.

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

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

שיטות
getBounds	getBounds() פרמטרים: ללא ערך החזרה:  LatLngBounds|undefined גבולות ההטיה. מחזירה את הגבולות שאליהם הטיות החיזויים.
getFields	getFields() פרמטרים: ללא הערך המוחזר:  Array<string>|undefined מחזירה את השדות שיש לכלול עבור המקום בתגובת הפרטים לאחר שהפרטים אוחזרו בהצלחה. לרשימת השדות יש לעיין ב-PlaceResult.
getPlace	getPlace() פרמטרים: ללא ערך החזרה:  PlaceResult המקום שנבחר על ידי המשתמש. מחזירה את הפרטים של המקום שנבחר על ידי המשתמש אם הפרטים אוחזרו בהצלחה. אחרת, מוחזר אובייקט 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 האם לאחזר רק מזהי מקומות. תוצאת ה-Place_id שתהיה זמינה כשהאירוע place_ changed (שינוי המקום) מופעל יכללו רק את השדות Place_id, types ו-name, והם יוחזרו על ידי שירות ההשלמה האוטומטית. התכונה מושבתת כברירת מחדל.
strictBounds optional	סוג:  boolean optional ערך בוליאני, שמציין שהווידג'ט של ההשלמה האוטומטית צריך להחזיר רק את המקומות שנמצאים בגבולות הווידג'ט של ההשלמה האוטומטית בזמן שליחת השאילתה. אם מגדירים את StrictBounds כ-false (ברירת המחדל) תהיה הטיה של התוצאות למקומות שנכללים בגבולות, אך לא רק.
types optional	סוג:  Array<string> optional סוגי החיזויים שיש להחזיר. הסוגים הנתמכים מפורטים במדריך למפתחים. אם לא מציינים סוגים, כל הסוגים יוחזרו.

סיווג של SearchBox

google.maps.places.SearchBox סיווג

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

הכיתה הזו משתרעת על פני MVCObject.

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

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

שיטות
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

ממשק google.maps.places.SearchBoxOptions

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

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