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

מתארים של כתובות מחזירים מידע נוסף לתגובת הקידוד הגיאוגרפי ההפוך הרגילה, שעוזרת לתאר את הקואורדינטות של קווי האורך והרוחב באמצעות ציוני דרך ואזורים. רוצים לנסות את ה-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.