Geocoder

הכיתה Geocoder

google.maps.Geocoder class

שירות להמרה בין כתובת ל-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) שרוצים לחפש. הכלי להמרת כתובות לקואורדינטות מבצע המרת קואורדינטות לכתובות (reverse geocoding). מידע נוסף זמין במאמר גיאוקוד הפוכה. צריך לספק רק אחד מבין address,‏ location ו-placeId.
placeId optional
סוג:  string optional
מזהה המקום שמשויך למיקום. המזהה הייחודי של מקום במסד הנתונים של 'מקומות Google' ובמפות Google. מידע נוסף על מזהי מקומות זמין במדריך למפתחים של Places API. הכלי להמרת כתובות לקואורדינטות מבצע המרת קואורדינטות לכתובות (reverse geocoding). מידע נוסף זמין במאמר גיאוקוד הפוך. צריך לספק רק אחד מבין address,‏ location ו-placeId.
region optional
סוג:  string optional
קוד המדינה שמשמש להטיה של החיפוש, שצוין בתג משנה של אזור Unicode (לא מספרי) בן שני תווים או במזהה CLDR. זה שינוי אופציונלי. כאן אפשר למצוא את רשימת האזורים הנתמכים בפלטפורמה של מפות 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 קובץ ה-cookie GeocoderRequest היה לא חוקי.
OK התשובה מכילה GeocoderResponse תקין.
OVER_QUERY_LIMIT דף האינטרנט חרג ממגבלת הבקשות בפרק זמן קצר מדי.
REQUEST_DENIED אין לדף האינטרנט הרשאה להשתמש במקודד הגיאוגרפיה.
UNKNOWN_ERROR לא ניתן היה לעבד בקשה להמרת כתובת לקואורדינטות (geocoding) בגלל שגיאה בשרת. יכול להיות שהבקשה תצליח אם תנסה שוב.
ZERO_RESULTS לא נמצאה תוצאה עבור GeocoderRequest הזה.

הממשק GeocoderResponse

ממשק google.maps.GeocoderResponse

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

הממשק GeocoderResult

ממשק google.maps.GeocoderResult

תוצאה אחת של שירות ניתוח המיקום שחולצה משרת ניתוח המיקום. בקשת גיאוקוד יכולה להחזיר כמה אובייקטים של תוצאות. שימו לב: התוצאה הזו 'דומה ל-JSON', אבל היא לא JSON לחלוטין, כי היא כוללת באופן עקיף אובייקט LatLng.
address_components
מערך של GeocoderAddressComponent
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
ה-Plus Code שמשויך למיקום.
postcode_localities optional
סוג:  Array<string> optional
מערך של מחרוזות שמציין את כל היישובים הכלולים במיקוד. האפשרות הזו מופיעה רק כשהתוצאה היא מיקוד שמכיל כמה יישובים.

הממשק GeocoderAddressComponent

ממשק google.maps.GeocoderAddressComponent

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

הממשק 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 התוצאה שמוחזרת משקפת כתובת גיאוגרפית מדויקת.