בקשה ותשובה של מתארי כתובת

מפתחים באזור הכלכלי האירופי (EEA)

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

פרמטרים נוספים

כדי להפעיל תיאורי מיקום, משתמשים בפרמטר extra_computations. כדי לקבל תיאורי כתובות בתגובה, צריך לכלול את extra_computations=ADDRESS_DESCRIPTORS בבקשה להמרת כתובות לקואורדינטות (geocoding), בבקשה להמרת קואורדינטות לכתובות (reverse geocoding) או בבקשה להמרת כתובות של מקומות לקואורדינטות.

דוגמה להמרת כתובות לקואורדינטות (geocoding)

השאילתה הבאה מכילה כתובת של מקום בדלהי:

https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

דוגמה להמרת כתובות לקואורדינטות (geocoding) של מקומות

השאילתה הבאה מכילה את מזהה המקום של מקום בדלהי:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

דוגמה להמרת קואורדינטות לכתובות (reverse geocoding)

השאילתה הבאה מכילה את הערך של קו הרוחב/קו האורך של מיקום בדלהי:

https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

תשובה

דוגמה ל-address_descriptor:

{
  "address_descriptor" : {
     "areas" : [
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Turkman Gate"
           },
           "place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
        },
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Chandni Chowk"
           },
           "place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
        },
        {
           "containment" : "NEAR",
           "display_name" : {
              "language_code" : "en",
              "text" : "Katar Ganj"
           },
           "place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
        }
     ],
     "landmarks" : [
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delite Cinema"
           },
           "straight_line_distance_meters" : 29.9306755065918,
           "place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
           "travel_distance_meters" : 418.7794799804688,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "establishment", "movie_theater", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "YES Bank"
           },
           "straight_line_distance_meters" : 66.83731079101562,
           "place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
           "travel_distance_meters" : 489.0340270996094,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "UCO Bank"
           },
           "straight_line_distance_meters" : 25.38849639892578,
           "place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
           "travel_distance_meters" : 403.2246398925781,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delhi By Cycle Meeting Point"
           },
           "straight_line_distance_meters" : 44.02867126464844,
           "place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
           "travel_distance_meters" : 97.41281890869141,
           "spatial_relationship" : "AROUND_THE_CORNER",
           "types" : [
              "establishment",
              "point_of_interest",
              "tourist_attraction",
              "travel_agency"
           ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Axis Bank Branch"
           },
           "straight_line_distance_meters" : 102.3495178222656,
           "place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
           "travel_distance_meters" : 330.8566284179688,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        }
     ]
  }
}

בכל אובייקט address_descriptor יש שני מערכים: landmarks ו-areas. המערך landmarks מכיל עד 5 תוצאות שמדורגות לפי מידת הרלוונטיות, בהתאם לקרבה לקואורדינטה המבוקשת, לשכיחות של נקודת הציון ולניראות שלה. כל תוצאה של נקודת ציון מכילה את הערכים הבאים:

  • ‫place_id הוא מזהה המקום של תוצאת נקודות הציון. סקירה כללית על מזהי מקומות
  • ‫display_name הוא השם המוצג של נקודת הציון, והוא מכיל את language_code ו-text.
  • ‫straight_line_distance_meters הוא המרחק במטרים בין הקואורדינטה שהוזנה לבין התוצאה של נקודת הציון.
  • ‫travel_distance_meters הוא המרחק במטרים של הנסיעה ברשת הכבישים (בלי להתייחס להגבלות בכבישים) בין הקואורדינטה שצוינה בקלט לבין תוצאת ציוני הדרך.
  • ‫spatial_relationship הוא הקשר המשוער בין קואורדינטת הקלט לבין תוצאת ציוני הדרך:
    • "NEAR" הוא הקשר שמוגדר כברירת מחדל אם אף אחד מהתנאים הבאים לא מתקיים.
    • ‫"WITHIN" כשהקואורדינטה של הקלט נמצאת בתוך הגבולות של המבנה שמשויך לנקודת הציון.
    • ‫"BESIDE" כשהקואורדינטה של הקלט נמצאת ממש ליד נקודת הציון או נקודת הגישה של נקודת הציון.
    • "ACROSS_THE_ROAD" כשהקואורדינטה של הקלט נמצאת בדיוק מול נקודת הציון בצד השני של המסלול.
    • "DOWN_THE_ROAD" כשהקואורדינטה של הקלט נמצאת באותו מסלול כמו נקודת הציון, אבל לא "BESIDES" או "ACROSS_THE_ROAD".
    • ‫"AROUND_THE_CORNER" כשהקואורדינטה של הקלט נמצאת לאורך מסלול שמאונך לנקודת הציון (מוגבל לפנייה אחת).
    • "BEHIND" כשהקואורדינטה של הקלט קרובה מבחינה מרחבית לנקודת הציון, אבל רחוקה מנקודת הגישה שלה.
  • ‫types הם סוגי המקומות של נקודת הציון.

האובייקט areas מכיל עד 3 תשובות ומוגבל למקומות שמייצגים אזורים קטנים, כמו שכונות, אזורי משנה ומתחמים גדולים. האזורים שמכילים את הקואורדינטה המבוקשת מופיעים ראשונים, בסדר עולה לפי הגודל שלהם. כל תוצאה של areas מכילה את הערכים הבאים:

  • ‫place_id הוא מזהה המקום של תוצאת האזורים. סקירה כללית על מזהי מקומות
  • ‫display_name הוא השם המוצג של האזור, והוא מכיל את language_code ו-text.
  • ‫containment הוא הקשר המשוער של ההכלה בין הקואורדינטה של הקלט לבין תוצאת האזורים:
    • "NEAR" הוא הקשר שמוגדר כברירת מחדל אם אף אחד מהתנאים הבאים לא מתקיים.
    • "WITHIN" כשהקואורדינטה של הקלט קרובה למרכז האזור.
    • ‫"OUTSKIRTS" כשהקואורדינטה של הקלט קרובה לקצה של האזור.

כיסוי

תיאורי כתובות זמינים בכל האזורים. לפרטים נוספים, ראו אזורי כיסוי.

משוב

התכונה הזו זמינה בכל האזורים, והיא נמצאת ב-GA בהודו ובשלב ההשקה הניסיוני של טרום-GA בכל שאר האזורים. נשמח לקבל משוב. נשמח לקבל דיווח על באג בIssue Tracker.