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

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

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

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

דוגמה בקידוד גיאוגרפי

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

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.