Places Widgets

שיעור בהשלמה אוטומטית

כיתה google.maps.places.PlaceAutocompleteElement

הערה: זמין רק בערוץ v=alpha.

יישום של השלמה אוטומטית של 'תצוגת מקומות'

בכיתה הזו מיישמים את PlaceAutocompleteElementOptions.

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

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

נכסים
element optional	סוג:  HTMLElement|SVGElement optional השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שמאחורי התצוגה.
inputElement	סוג:  HTMLInputElement רכיב הקלט להצגת השלמות אוטומטיות.
הועבר בירושה: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types

שיטות
addListener	addListener(eventName, handler) פרמטרים:  eventName:  string handler:  Function ערך החזרה:  MapsEventListener הפונקציה מוסיפה את פונקציית ההאזנה הנתונה לשם האירוע.

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

הממשק של PlacecompleteElementOptions

ממשק google.maps.places.PlaceAutocompleteElementOptions

הערה: זמין רק בערוץ v=alpha.

אפשרויות לבניית השלמה אוטומטית של מקום.

נכסים
inputElement	סוג:  HTMLInputElement רכיב הקלט להצגת השלמות אוטומטיות.
componentRestrictions optional	סוג:  ComponentRestrictions optional ההגבלות על הרכיבים. ההגבלות על רכיבים משמשות להגבלת החיזויים רק לאלו שנכללים ברכיב ההורה. למשל, המדינה.
element optional	סוג:  HTMLElement|SVGElement optional השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שמאחורי התצוגה.
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 סוגי החיזויים שיש להחזיר. לגבי סוגים נתמכים, אפשר לעיין במדריך למפתחים. אם לא מציינים שום סוג, מוחזרים כל הסוגים.

שיעור השלמה אוטומטית

כיתה google.maps.places.Autocomplete

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

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

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

יצרן
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, ולא הוגדרו מאפיינים אחרים.

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

ממשק 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 שהופך לזמין כשהאירוע event_changed מופעל כולל רק את ה-place_id, סוגי השמות והשדות, ו-place_id, סוגים ותיאור שמוחזרים על ידי שירות ההשלמה האוטומטית. האפשרות מושבתת כברירת מחדל.
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"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.

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