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

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

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

אפשר להפעיל את מתארי הכתובות באמצעות הפרמטר extra_computations. כדי לקבל תיאורי כתובות בתגובה, צריך לכלול את extra_computations=ADDRESS_DESCRIPTORS בבקשה להמרת כתובות לקואורדינטות (geocoding), בבקשה להמרת קואורדינטות לכתובת (reverse geocoding) או בבקשה להמרת כתובות של מקומות (places 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

דוגמה לגיאוקוד של מקומות

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

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

דוגמה לפעולה של גיאוקודינג הפוך

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

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" כאשר קואורדינטת הקלט קרובה לקצה האזור.

כיסוי

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

משוב

זוהי תכונה בגרסת 'תצוגה מקדימה', ונשמח לקבל משוב. אפשר לשלוח לנו אימייל לכתובת address-descriptors-feedback@google.com.