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

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

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

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

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

כיסוי

מתארי הכתובות זמינים בכל האזורים. למידע נוסף, ראו כיסוי באזור.

משוב

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