Geocoder

מחלקה של Geocoder

google.maps.Geocoder סיווג

שירות להמרה בין כתובת לבין LatLng.

ניתן לגשת באמצעות חיוג אל const {Geocoder} = await google.maps.importLibrary("geocoding"). ראה ספריות ב-Maps JavaScript API.
Geocoder
Geocoder()
פרמטרים: ללא
יצירת מופע חדש של Geocoder ששולח בקשות לקידוד גיאוגרפי לשרתים של Google.
geocode
geocode(request[, callback])
פרמטרים: 
הערך המוחזר:  Promise<GeocoderResponse>
לבצע קידוד גיאוגרפי של בקשה.

ממשק GeocoderRequest

ממשק google.maps.GeocoderRequest

המפרט של בקשת קידוד גיאוגרפי תישלח אל Geocoder.
address optional
סוג:  string optional
הכתובת לקואורדינטות. יש לספק אחד, ורק אחד, מתוך address, location ו-placeId.
bounds optional
LatLngBounds שבהם יש לחפש. זה שינוי אופציונלי.
componentRestrictions optional
המערכת משתמשת ברכיבים כדי להגביל את התוצאות לאזור מסוים. מסנן מורכב מאחד או יותר מהרכיבים הבאים: route, locality, administrativeArea, postalCode, country. רק התוצאות שתואמות לכל המסננים יוחזרו. ערכי מסננים תומכים באותן שיטות לתיקון איות ולהתאמה חלקית כמו בקשות אחרות של קידוד גיאוגרפי. זה שינוי אופציונלי.
language optional
סוג:  string optional
מזהה השפה של השפה שבה התוצאות יוחזרו, כשהדבר אפשרי. כאן אפשר לעיין ברשימת השפות הנתמכות.
location optional
סוג:  LatLng|LatLngLiteral optional
LatLng (או LatLngLiteral) לחיפוש. הממיר הגיאוגרפי מבצע קידוד גיאוגרפי הפוך. למידע נוסף, ראו הפוך קידוד גיאוגרפי. יש לספק אחד, ורק אחד, מתוך address, location ו-placeId.
placeId optional
סוג:  string optional
מזהה המקום שמשויך למיקום. מזהי המקומות מזהים מקום באופן ייחודי במסד הנתונים של 'מקומות Google' ובמפות Google. למידע נוסף על מזהי מקומות במדריך למפתחים של Places API. הממיר הגיאוגרפי מבצע קידוד גיאוגרפי הפוך. למידע נוסף, ראו המרת קידוד גיאוגרפי הפוך. יש לספק אחד, ורק אחד, מתוך address, location ו-placeId.
region optional
סוג:  string optional
קוד המדינה המשמש להטיית החיפוש, שמצוין כתג משנה אזורי / CLDR בן שני תווים (לא מספרי) לפי אזור Unicode. זה שינוי אופציונלי. מידע על האזורים הנתמכים זמין בפרטי הכיסוי של הפלטפורמה של מפות Google.

הממשק של GeocoderComponentRestrictions

ממשק 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. זה שינוי אופציונלי.

קבועים של GeocoderStatus

google.maps.GeocoderStatus קבועים

הסטטוס שהוחזר על ידי Geocoder במהלך שיחה אל geocode(). צריך לציין את הערכים האלה לפי ערך או על ידי שימוש בשם הקבוע. לדוגמה, 'OK' או google.maps.GeocoderStatus.OK.

ניתן לגשת באמצעות חיוג אל const {GeocoderStatus} = await google.maps.importLibrary("geocoding"). ראה ספריות ב-Maps JavaScript API.
ERROR הייתה בעיה ביצירת קשר עם שרתי Google.
INVALID_REQUEST הערך של GeocoderRequest לא חוקי.
OK התשובה מכילה GeocoderResponse חוקי.
OVER_QUERY_LIMIT דף האינטרנט חרג ממגבלת הבקשות בפרק זמן קצר מדי.
REQUEST_DENIED דף האינטרנט אינו מורשה להשתמש בממיר הגיאוגרפי.
UNKNOWN_ERROR לא ניתן היה לעבד בקשה לקידוד גיאוגרפי עקב שגיאה בחיבור לשרת. ניסיון חוזר של הבקשה עשוי להתבצע בהצלחה.
ZERO_RESULTS לא נמצאה תוצאה עבור GeocoderRequest.

ממשק GeocoderResponse

ממשק google.maps.GeocoderResponse

תגובת מקודד גיאוגרפי שמוחזרת על ידי Geocoder שמכילה את הרשימה של GeocoderResult.
results
הרשימה של GeocoderResult.

ממשק GeocoderResult

ממשק google.maps.GeocoderResult

תוצאת קואורדינטות אחת אוחזרה משרת הקואורדינטות. בקשה לקידוד גיאוגרפי עשויה להחזיר מספר אובייקטי תוצאה. חשוב לשים לב שהתוצאה הזו היא "כמו JSON", אבל זה לא קובץ JSON בלבד כי הוא כולל באופן עקיף אובייקט LatLng.
address_components
מערך של GeocoderAddressComponents
formatted_address
סוג:  string
מחרוזת שמכילה את הכתובת של המיקום הזה, שאנשים יכולים לקרוא.
geometry
אובייקט GeocoderGeometry
place_id
סוג:  string
מזהה המקום שמשויך למיקום. מזהי המקומות מזהים מקום באופן ייחודי במסד הנתונים של 'מקומות Google' ובמפות Google. למידע נוסף על מזהי מקומות במדריך למפתחים של Places API.
types
סוג:  Array<string>
מערך של מחרוזות שמציינות את סוג הרכיב המוחזר בקידוד גיאוגרפי. לרשימה של מחרוזות אפשריות, יש לעיין בקטע סוגי רכיבי הכתובת במדריך למפתחים.
partial_match optional
סוג:  boolean optional
האם המקודד הגיאוגרפי לא החזיר התאמה מדויקת עבור הבקשה המקורית, על אף שהוא הצליח להתאים לחלק מהכתובת המבוקשת. אם ההתאמה המדויקת תהיה התאמה, הערך יהיה undefined.
plus_code optional
סוג:  PlacePlusCode optional
ה-OLC המשויך למיקום.
postcode_localities optional
סוג:  Array<string> optional
מערך של מחרוזות שמציינות את כל המיקומים שנכללים במיקוד. השדה הזה מוצג רק כשהתוצאה היא מיקוד שמכיל מספר רשויות מקומיות.

ממשק GeocoderAddressComponent

ממשק google.maps.GeocoderAddressComponent

רכיב כתובת יחיד בתוך GeocoderResult. כתובת מלאה יכולה לכלול כמה רכיבי כתובת.
long_name
סוג:  string
הטקסט המלא של רכיב הכתובת
short_name
סוג:  string
הטקסט המקוצר והקצר של רכיב הכתובת הנתון
types
סוג:  Array<string>
מערך של מחרוזות שמציינות את הסוג של רכיב הכתובת הזה. כאן מופיעה רשימה של סוגים חוקיים

ממשק GeocoderGeometry

ממשק google.maps.GeocoderGeometry

מידע גיאומטרי על GeocoderResult הזה
location
סוג:  LatLng
קווי האורך והרוחב של התוצאה הזו
location_type
סוג המיקום שהוחזר בlocation
viewport
סוג:  LatLngBounds
הגבולות של אזור התצוגה המומלץ להצגת GeocoderResult זה
bounds optional
סוג:  LatLngBounds optional
הגבולות המדויקים של GeocoderResult זה, אם רלוונטי

קבועים של GeocoderLocationType

google.maps.GeocoderLocationType קבועים

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

ניתן לגשת באמצעות חיוג אל const {GeocoderLocationType} = await google.maps.importLibrary("geocoding"). ראה ספריות ב-Maps JavaScript API.
APPROXIMATE התוצאה שהוחזרה היא אומדן.
GEOMETRIC_CENTER התוצאה שמוחזרת היא המרכז הגאומטרי של תוצאה כמו קו (למשל רחוב) או פוליגון (אזור).
RANGE_INTERPOLATED התוצאה שמוחזרת משקפת אומדן (בדרך כלל על כביש) שעבר אינטרפולציה בין שתי נקודות מדויקות (כגון צמתים). בדרך כלל, תוצאות אינטרפולציה מוחזרות כאשר אין קודים גיאוגרפיים על הגגות עבור כתובת רחוב.
ROOFTOP התוצאה שמוחזרת משקפת קואורדינטות מדויקות.