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