בקשה ותגובה של מתארי כתובת קידוד גיאוגרפי הפוך

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

היפוך בקשות לקידוד גיאוגרפי – פרמטרים נוספים

פרמטרים אופציונליים

אלה הפרמטרים האופציונליים שאפשר לכלול בבקשת קידוד גיאוגרפי הפוך:

דוגמה לקידוד גיאוגרפי הפוך

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

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

תשובה

השאילתה שלמעלה מחזירה 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" ]
        }
     ]
  },
 ... Results (reverse geocoding response) ...

בכל אובייקט 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.