Geocoder

‫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]) פרמטרים:  request:  GeocoderRequest callback:  function(Array<GeocoderResult> optional, GeocoderStatus): void optional ערך מוחזר:  Promise<GeocoderResponse> קידוד גיאוגרפי של בקשה.

‫GeocoderRequest interface

google.maps.GeocoderRequest ממשק

הגדרת בקשת גיאו-קידוד שתישלח אל Geocoder.

מאפיינים
address optional	סוג:  string optional הכתובת שצריך להמיר לקואורדינטות. צריך לספק רק אחד מהמאפיינים הבאים: address, location ו-placeId.
bounds optional	סוג:  LatLngBounds|LatLngBoundsLiteral optional LatLngBounds שבו יתבצע החיפוש. אופציונלי.
componentRestrictions optional	סוג:  GeocoderComponentRestrictions optional רכיבים משמשים להגבלת התוצאות לאזור ספציפי. פילטר מורכב מאחד או יותר מהרכיבים הבאים: route, ‏ locality, ‏ administrativeArea, ‏ postalCode, ‏ country. יוחזרו רק התוצאות שתואמות לכל המסננים. ערכי המסנן תומכים באותן שיטות של תיקון איות והתאמה חלקית כמו בקשות אחרות לגיאו-קידוד. אופציונלי.
extraComputations optional	הערה: התכונה זמינה רק בערוץ v=beta. סוג:  Array<ExtraGeocodeComputation> optional רשימה של חישובים נוספים שאפשר להשתמש בהם כדי להשלים את הבקשה. הערה: יכול להיות שהחישובים הנוספים האלה יחזירו שדות נוספים בתשובה.
fulfillOnZeroResults optional	סוג:  boolean optional ממלאים את ההבטחה בסטטוס ZERO_RESULT בתגובה. יכול להיות שתרצו לעשות את זה כי גם אם אין תוצאות של קידוד גיאוגרפי, יכול להיות שעדיין יוחזרו שדות נוספים ברמת התגובה.
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 קוד המדינה שמשמש להטיית החיפוש, מוגדר כתווית משנה של אזור 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

הערה: התכונה זמינה רק בערוץ v=beta.

חישובים נוספים שצריך לבצע כדי להשלים בקשה לגיאו-קידוד.

אפשר להתקשר אל 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.
address_descriptor optional	הערה: התכונה זמינה רק בערוץ v=beta. סוג:  AddressDescriptor optional תיאור יחסי של מיקום. כולל קבוצה מדורגת של ציוני דרך בקרבת מקום והאזורים שבהם נמצא מיקום היעד. השדה הזה מאוכלס רק בבקשות לגיאו-קידוד הפוך, ורק אם האפשרות ExtraGeocodeComputation.ADDRESS_DESCRIPTORS מופעלת.
plus_code optional	סוג:  PlacePlusCode optional ה-Plus Code שמשויך למיקום.

‫GeocoderResult ממשק

google.maps.GeocoderResult ממשק

תוצאה יחידה של גיאו-קוד שהוחזרה משרת הגיאו-קוד. בקשה לגיאו-קוד עשויה להחזיר כמה אובייקטים של תוצאות. שימו לב: למרות שהתוצאה הזו היא "בסגנון JSON", היא לא JSON במובן המדויק, כי היא כוללת באופן עקיף אובייקט LatLng.

מאפיינים
address_components	סוג:  Array<GeocoderAddressComponent> מערך של GeocoderAddressComponent
formatted_address	סוג:  string מחרוזת שמכילה את הכתובת של המיקום הזה, שאנשים יכולים לקרוא.
geometry	סוג:  GeocoderGeometry אובייקט GeocoderGeometry
place_id	סוג:  string מזהה המקום שמשויך למיקום. מזהה מקום הוא מזהה ייחודי של מקום במסד הנתונים של מקומות Google ובמפות Google. מידע נוסף על מזהי מקומות זמין במדריך למפתחים של Places API.
types	סוג:  Array<string> מערך של מחרוזות שמציין את הסוג של הרכיב הגיאוקודי שמוחזר. רשימה של מחרוזות אפשריות מופיעה בקטע סוגים של רכיבי כתובת במדריך למפתחים.
address_descriptor optional	הערה: התכונה זמינה רק בערוץ v=beta. סוג:  AddressDescriptor optional תיאור יחסי של המיקום שמשויך לקוד הגיאוגרפי הזה. כולל קבוצה מדורגת של ציוני דרך בקרבת מקום והאזורים שבהם נמצא מיקום היעד. השדה הזה יאוכלס רק בבקשות לגיאו-קידוד קדימה ולחיפוש מזהה מקום, רק אם האפשרות ExtraGeocodeComputation.ADDRESS_DESCRIPTORS מופעלת ורק עבור מקומות מקומיים מסוימים.
partial_match optional	סוג:  boolean optional האם הגיאוקודר לא החזיר התאמה מדויקת לבקשה המקורית, אבל הצליח להתאים חלק מכתובת הבקשה. אם מדובר בהתאמה מדויקת, הערך יהיה undefined.
plus_code optional	סוג:  PlacePlusCode optional ה-Plus Code שמשויך למיקום.
postcode_localities optional	סוג:  Array<string> optional מערך של מחרוזות שמציין את כל היישובים שכלולים במיקוד. האפשרות הזו מופיעה רק אם התוצאה היא מיקוד שכולל כמה יישובים.

ממשק AddressDescriptor

google.maps.AddressDescriptor ממשק

הערה: התכונה זמינה רק בערוץ v=beta.

תיאור יחסי של מיקום. כולל קבוצה מדורגת של ציוני דרך בקרבת מקום והאזורים שבהם נמצא מיקום היעד.

מאפיינים
areas	סוג:  Array<Area> רשימה מדורגת של אזורים סמוכים או אזורים שמכילים את המיקום. האזורים הכי שימושיים (מוכרים ומדויקים) מדורגים ראשונים.
landmarks	סוג:  Array<Landmark> רשימה מדורגת של ציוני דרך בקרבת מקום. ציוני הדרך המועילים ביותר (המוכרים והקרובים) מדורגים ראשונים.

ממשק GeocoderAddressComponent

google.maps.GeocoderAddressComponent ממשק

רכיב כתובת יחיד בתוך GeocoderResult. כתובת מלאה יכולה לכלול כמה רכיבי כתובת.

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

ממשק GeocoderGeometry

google.maps.GeocoderGeometry ממשק

מידע גיאומטרי על GeocoderResult

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

GeocoderLocationType constants

google.maps.GeocoderLocationType constants

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

אפשר להתקשר אל const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

Constants
APPROXIMATE	התוצאה שמתקבלת היא משוערת.
GEOMETRIC_CENTER	התוצאה שמוחזרת היא המרכז הגיאומטרי של תוצאה כמו קו (למשל רחוב) או מצולע (אזור).
RANGE_INTERPOLATED	התוצאה שמוחזרת משקפת קירוב (בדרך כלל בכביש) שחושב על ידי אינטרפולציה בין שתי נקודות מדויקות (למשל צמתים). בדרך כלל, תוצאות משוערות מוחזרות כשאין נתוני מיקום גיאוגרפי של גגות לכתובת רחוב.
ROOFTOP	התוצאה שמוחזרת משקפת קידוד גיאוגרפי מדויק.

Landmark interface

google.maps.Landmark ממשק

הערה: התכונה זמינה רק בערוץ v=beta.

מקום שמייצג נקודת התייחסות לכתובת.

מאפיינים
display_name	סוג:  string השם של ציון הדרך.
display_name_language_code	סוג:  string השפה של השם של ציון הדרך.
place_id	סוג:  string מזהה המקום של העסק הבסיסי שמשמש כנקודת ציון. אפשר להשתמש בפרמטר הזה כדי לקבל מידע נוסף על ציון הדרך באמצעות Place Details או Place Id Lookup.
spatial_relationship	סוג:  SpatialRelationship הגדרת היחס המרחבי בין מיקום היעד לבין נקודת הציון.
straight_line_distance_meters	סוג:  number המרחק בקו ישר בין מיקום היעד לבין נקודת הציון.
types	סוג:  Array<string> ערך אחד או יותר שמציינים את סוג התוצאה שמוחזרת. פרטים נוספים מופיעים במאמר סוגים .
travel_distance_meters optional	סוג:  number optional מרחק הנסיעה לאורך רשת הכבישים בין מיקום היעד לבין נקודת הציון. יכול להיות שהשדה הזה יהיה ריק אם נקודת הציון לא מחוברת לחלק של רשת הכבישים שהיעד הכי קרוב אליו, או אם מיקום היעד לא נחשב כמיקום ברשת הכבישים.

ממשק Area

google.maps.Area ממשק

הערה: התכונה זמינה רק בערוץ v=beta.

מקום שהוא אזור קטן, כמו שכונה, אזור משנה או מתחם גדול שמכיל את מיקום היעד.

מאפיינים
containment	סוג:  Containment המאפיין מגדיר את היחס המרחבי בין מיקום היעד לבין האזור.
display_name	סוג:  string השם של האזור.
display_name_language_code	סוג:  string השפה של השם של האזור.
place_id	סוג:  string מזהה המקום של האזור הבסיסי. אפשר להשתמש בו כדי לקבל מידע נוסף על האזור באמצעות פרטי מקום או חיפוש מזהה מקום.

Containment constants

google.maps.Containment constants

הערה: התכונה זמינה רק בערוץ v=beta.

סוג enum שמייצג את היחס המרחבי בין האזור לבין מיקום היעד.

אפשר להתקשר אל const {Containment} = await google.maps.importLibrary("geocoding") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

Constants
NEAR	מיקום היעד נמצא מחוץ לאזור, אבל קרוב אליו.
OUTSKIRTS	מיקום היעד נמצא באזור, קרוב לקצה.
WITHIN	המיקום הגיאוגרפי לטירגוט נמצא באזור, קרוב למרכז.

קבועי SpatialRelationship

google.maps.SpatialRelationship constants

הערה: התכונה זמינה רק בערוץ v=beta.

סוג enum שמייצג את הקשר במרחב בין נקודת הציון לבין היעד.

אפשר להתקשר אל const {SpatialRelationship} = await google.maps.importLibrary("geocoding") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

Constants
ACROSS_THE_ROAD	היעד נמצא בדיוק מול נקודת הציון, בצד השני של הכביש.
AROUND_THE_CORNER	לא נמצא על אותו מסלול כמו נקודת הציון, אבל נמצא במרחק פנייה אחת.
BEHIND	קרוב למבנה של ציון הדרך אבל רחוק יותר מנקודת הגישה שלו.
BESIDE	היעד נמצא בסמוך לנקודת הציון.
DOWN_THE_ROAD	באותו מסלול כמו נקודת הציון, אבל לא לידה או מולה.
NEAR	זהו סוג ברירת המחדל של קשרי הגומלין אם אף אחת מההגדרות הספציפיות יותר שבהמשך לא חלה.
WITHIN	האתר המפורסם כולל גיאומטריה מרחבית והיעד נמצא בגבולות שלו.