Geocoder class
google.maps.Geocoder
class
שירות להמרה בין כתובת לבין LatLng.
אפשר להתקשר אל const {Geocoder} = await google.maps.importLibrary("geocoding") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
יצרן | |
|---|---|
Geocoder |
Geocoder()פרמטרים: אין
יוצר מופע חדש של Geocoder ששולח בקשות לגיאו-קידוד לשרתים של Google. |
Methods | |
|---|---|
geocode |
geocode(request[, callback])פרמטרים:
ערך מוחזר:
Promise<GeocoderResponse>קידוד גיאוגרפי של בקשה. |
GeocoderRequest interface
google.maps.GeocoderRequest
ממשק
הגדרת בקשת גיאו-קידוד שתישלח אל Geocoder.
מאפיינים | |
|---|---|
address optional |
סוג:
string optionalהכתובת שצריך להמיר לקואורדינטות. צריך לספק רק אחד מהמאפיינים הבאים: address, location ו-placeId. |
bounds optional |
סוג:
LatLngBounds|LatLngBoundsLiteral optionalLatLngBounds שבו יתבצע החיפוש. אופציונלי. |
componentRestrictions optional |
סוג:
GeocoderComponentRestrictions optionalרכיבים משמשים להגבלת התוצאות לאזור ספציפי. פילטר מורכב מאחד או יותר מהרכיבים הבאים: route, locality, administrativeArea, postalCode, country. יוחזרו רק התוצאות שתואמות לכל המסננים. ערכי המסנן תומכים באותן שיטות של תיקון איות והתאמה חלקית כמו בקשות אחרות לגיאו-קידוד. אופציונלי. |
|
סוג:
Array<ExtraGeocodeComputation> optionalרשימה של חישובים נוספים שאפשר להשתמש בהם כדי להשלים את הבקשה. הערה: יכול להיות שהחישובים הנוספים האלה יחזירו שדות נוספים בתשובה. |
fulfillOnZeroResults optional |
סוג:
boolean optionalממלאים את ההבטחה בסטטוס ZERO_RESULT בתגובה. יכול להיות שתרצו לעשות את זה כי גם אם אין תוצאות של קידוד גיאוגרפי, יכול להיות שעדיין יוחזרו שדות נוספים ברמת התגובה. |
language optional |
סוג:
string optionalמזהה שפה של השפה שבה צריך להחזיר את התוצאות, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות. |
location optional |
סוג:
LatLng|LatLngLiteral optionalLatLng (או LatLngLiteral) שרוצים לחפש. הכלי להמרת כתובות לקואורדינטות מבצע המרה הפוכה של קואורדינטות לכתובות. מידע נוסף זמין במאמר בנושא מיקום גיאוגרפי הפוך. צריך לספק רק אחד מהמאפיינים הבאים: address, location ו-placeId. |
placeId optional |
סוג:
string optionalמזהה המקום שמשויך למיקום. מזהה מקום הוא מזהה ייחודי של מקום במסד הנתונים של מקומות Google ובמפות Google. מידע נוסף על מזהי מקומות זמין במדריך למפתחים של Places API. הכלי להמרת כתובות לקואורדינטות מבצע המרה הפוכה של קואורדינטות לכתובות. מידע נוסף זמין במאמר בנושא גיאו-קידוד הפוך. צריך לספק רק אחד מהמאפיינים הבאים: address, location ו-placeId. |
region optional |
סוג:
string optionalקוד המדינה שמשמש להטיית החיפוש, מוגדר כתווית משנה של אזור Unicode (שאינה מספרית) / מזהה CLDR באורך שני תווים. אופציונלי. אפשר לעיין בפרטים על הכיסוי של הפלטפורמה של מפות Google כדי לראות את האזורים הנתמכים. |
GeocoderComponentRestrictions interface
google.maps.GeocoderComponentRestrictions
ממשק
GeocoderComponentRestrictions מייצג קבוצה של מסננים שמציינים אזור מסוים. פרטים על אופן הפעולה מופיעים במאמר בנושא סינון רכיבי קידוד גיאוגרפי.
מאפיינים | |
|---|---|
administrativeArea optional |
סוג:
string optionalהתאמה לכל administrative_area levels. אופציונלי. |
country optional |
סוג:
string optionalהתנאי תואם לשם של מדינה או לקוד מדינה בן שתי אותיות לפי תקן ISO 3166-1. אופציונלי. |
locality optional |
סוג:
string optionalההתאמה היא לסוגים locality ו-sublocality. אופציונלי. |
postalCode optional |
סוג:
string optionalתואם ל- postal_code ול-postal_code_prefix. אופציונלי. |
route optional |
סוג:
string optionalהשם זהה לשם הארוך או הקצר של route. אופציונלי. |
ExtraGeocodeComputation constants
google.maps.ExtraGeocodeComputation
constants
חישובים נוספים שצריך לבצע כדי להשלים בקשה לגיאו-קידוד.
אפשר להתקשר אל const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
Constants | |
|---|---|
ADDRESS_DESCRIPTORS |
יצירת תיאור כתובת. |
קבועי GeocoderStatus
google.maps.GeocoderStatus
constants
הסטטוס שמוחזר על ידי Geocoder בסיום שיחה אל geocode(). אפשר לציין אותם לפי ערך או באמצעות שם הקבוע. לדוגמה, 'OK' או google.maps.GeocoderStatus.OK.
אפשר להתקשר אל const {GeocoderStatus} = await google.maps.importLibrary("geocoding") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
Constants | |
|---|---|
ERROR |
הייתה בעיה ביצירת קשר עם שרתי Google. |
INVALID_REQUEST |
הערך GeocoderRequest לא תקין. |
OK |
התשובה מכילה GeocoderResponse תקין. |
OVER_QUERY_LIMIT |
הדף חרג ממגבלת הבקשות בפרק זמן קצר מדי. |
REQUEST_DENIED |
לדף האינטרנט אין הרשאה להשתמש בגיאוקודר. |
UNKNOWN_ERROR |
לא ניתן לעבד בקשה לגיאו-קידוד בגלל שגיאה בחיבור לשרת. אם תנסו שוב, יכול להיות שהבקשה תצליח. |
ZERO_RESULTS |
לא נמצאה תוצאה ל-GeocoderRequest הזה. |
GeocoderResponse interface
google.maps.GeocoderResponse
ממשק
תגובה של Geocoder שמוחזרת על ידי Geocoder ומכילה את רשימת GeocoderResult.
מאפיינים | |
|---|---|
results |
סוג:
Array<GeocoderResult>רשימה של GeocoderResult. |
|
סוג:
AddressDescriptor optionalתיאור יחסי של מיקום. כולל קבוצה מדורגת של ציוני דרך בקרבת מקום והאזורים שבהם נמצא מיקום היעד. השדה הזה מאוכלס רק בבקשות לגיאו-קידוד הפוך, ורק אם האפשרות ExtraGeocodeComputation.ADDRESS_DESCRIPTORS מופעלת. |
plus_code optional |
סוג:
PlacePlusCode optionalה-Plus Code שמשויך למיקום. |
GeocoderResult ממשק
google.maps.GeocoderResult
ממשק
תוצאה יחידה של גיאו-קוד שהוחזרה משרת הגיאו-קוד. בקשה לגיאו-קוד עשויה להחזיר כמה אובייקטים של תוצאות. שימו לב: למרות שהתוצאה הזו היא "בסגנון JSON", היא לא JSON במובן המדויק, כי היא כוללת באופן עקיף אובייקט LatLng.
מאפיינים | |
|---|---|
address_components |
מערך של GeocoderAddressComponent |
formatted_address |
סוג:
stringמחרוזת שמכילה את הכתובת של המיקום הזה, שאנשים יכולים לקרוא. |
geometry |
סוג:
GeocoderGeometryאובייקט GeocoderGeometry |
place_id |
סוג:
stringמזהה המקום שמשויך למיקום. מזהה מקום הוא מזהה ייחודי של מקום במסד הנתונים של מקומות Google ובמפות Google. מידע נוסף על מזהי מקומות זמין במדריך למפתחים של Places API. |
types |
סוג:
Array<string>מערך של מחרוזות שמציין את הסוג של הרכיב הגיאוקודי שמוחזר. רשימה של מחרוזות אפשריות מופיעה בקטע סוגים של רכיבי כתובת במדריך למפתחים. |
|
|