שיעור בהשלמה אוטומטית
כיתה google.maps.places.PlaceAutocompleteElement
יישום של השלמה אוטומטית של 'תצוגת מקומות'
בכיתה הזו מיישמים את PlaceAutocompleteElementOptions
.
כדי לקבל גישה, צריך להתקשר ל-const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
. כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
יצרן | |
---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement(options) פרמטרים:
|
נכסים | |
---|---|
element optional |
סוג:
HTMLElement|SVGElement optional השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שמאחורי התצוגה. |
inputElement |
סוג:
HTMLInputElement רכיב הקלט להצגת השלמות אוטומטיות. |
הועבר בירושה:
componentRestrictions ,
locationBias ,
locationRestriction ,
requestedLanguage ,
requestedRegion ,
types
|
שיטות | |
---|---|
addListener |
addListener(eventName, handler) פרמטרים:
ערך החזרה:
MapsEventListener הפונקציה מוסיפה את פונקציית ההאזנה הנתונה לשם האירוע. |
אירועים | |
---|---|
gmp-placeselect |
function(place) ארגומנטים:
האירוע הזה מופעל כשמשתמש בוחר חיזוי למקום. מחזירה אובייקט מקום. |
gmp-requesterror |
function() ארגומנטים: ללא
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל מפתח API שגוי). האירוע הזה לא בועות. |
הממשק של PlacecompleteElementOptions
ממשק google.maps.places.PlaceAutocompleteElementOptions
אפשרויות לבניית השלמה אוטומטית של מקום.
נכסים | |
---|---|
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]) פרמטרים:
יוצרת מופע חדש של Autocomplete שמצורף לשדה הטקסט שהוזן, עם האפשרויות שמופיעות. |
שיטות | |
---|---|
getBounds |
getBounds() פרמטרים: ללא
ערך החזרה:
LatLngBounds|undefined הגבולות.מחזירה את הגבולות שאליהם החיזוי הטיה. |
getFields |
getFields() פרמטרים: ללא
ערך החזרה:
Array<string>|undefined מחזיר את השדות שיש לכלול עבור המקום בתגובת הפרטים כאשר הפרטים מאוחזרים בהצלחה. רשימה של שדות זמינה בכתובת PlaceResult . |
getPlace |
getPlace() פרמטרים: ללא
ערך החזרה:
PlaceResult המקום שהמשתמש בחר.מחזיר את פרטי המקום שנבחר על ידי המשתמש אם הפרטים אוחזרו בהצלחה. אחרת, מחזירה אובייקט מסוג stub מקום, כאשר המאפיין name מוגדר לערך הנוכחי של שדה הקלט. |
setBounds |
setBounds(bounds) פרמטרים:
ערך החזרה: אין
הגדרת האזור המועדף להחזרת תוצאות של מקומות. התוצאות מכוונות לאזור זה, אך אינן מוגבלות. |
setComponentRestrictions |
setComponentRestrictions(restrictions) פרמטרים:
ערך החזרה: אין
הגדרת ההגבלות על הרכיבים. ההגבלות על רכיבים משמשות להגבלת החיזויים רק לאלו שנכללים ברכיב ההורה. למשל, המדינה. |
setFields |
setFields(fields) פרמטרים:
ערך החזרה: אין
המדיניות הזו מגדירה את השדות שייכללו במקום בתגובת הפרטים כשהפרטים יאוחזרו בהצלחה. רשימה של שדות זמינה בכתובת PlaceResult . |
setOptions |
setOptions(options) פרמטרים:
ערך החזרה: אין
|
setTypes |
setTypes(types) פרמטרים:
ערך החזרה: אין
מגדירה את סוגי החיזויים שיש להחזיר. לגבי סוגים נתמכים, אפשר לעיין במדריך למפתחים. אם לא מציינים שום סוג, מוחזרים כל הסוגים. |
הועבר בירושה:
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'] . |
|
סוג:
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]) פרמטרים:
יוצרת מופע חדש של SearchBox שמצורף לשדה הטקסט שהוזן, עם האפשרויות שמופיעות. |
שיטות | |
---|---|
getBounds |
getBounds() פרמטרים: ללא
ערך החזרה:
LatLngBounds|undefined מחזירה את הגבולות שאליהם החיזוי של השאילתה מוטה. |
getPlaces |
getPlaces() פרמטרים: ללא
ערך החזרה:
Array<PlaceResult>|undefined מחזירה את השאילתה שהמשתמש בחר לשימוש באירוע places_changed . |
setBounds |
setBounds(bounds) פרמטרים:
ערך החזרה: אין
מגדיר את האזור לשימוש עבור חיזוי שאילתות. התוצאות יוטות רק לאזור הזה ולא יוגבלו לגמרי לגביו. |
הועבר בירושה:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
אירועים | |
---|---|
places_changed |
function() ארגומנטים: ללא
האירוע הזה מופעל כשהמשתמש בוחר שאילתה, יש להשתמש ב- getPlaces כדי למצוא מקומות חדשים. |
ממשק SearchBoxOptions
ממשק google.maps.places.SearchBoxOptions
האפשרויות שניתן להגדיר באובייקט SearchBox
.
נכסים | |
---|---|
bounds optional |
סוג:
LatLngBounds|LatLngBoundsLiteral optional האזור שבו יש להטות את החיזויים של השאילתות. החיזוי מוטה לשאילתות, אך לא רק, לשאילתות שמטרגטות את הגבולות האלה. |