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