تتضمّن أوصاف العناوين معلومات إضافية تساعد في وصف الموقع الجغرافي باستخدام المعالم والمناطق. اطّلِع على العرض التقديمي لوصف العناوين لاستكشاف الميزة.
المَعلمات الإضافية
يمكن تفعيل أوصاف العناوين باستخدام المَعلمة 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 ردود ويقتصر على الأماكن التي represent مناطق صغيرة، مثل الأحياء والمناطق الفرعية والمجمعات الكبيرة. يتم إدراج المناطق التي تحتوي على الإحداثي المطلوب أولاً ويتم ترتيبها من الأصغر إلى الأكبر. تحتوي كل نتيجة من نتائج areas
على
القيم التالية:
place_id
هو معرّف المكان لنتيجة المناطق. اطّلِع على نظرة عامة على رقم تعريف المكان.display_name
هو الاسم المعروض للمنطقة ويحتوي علىlanguage_code
وtext
.containment
هي علاقة الالتفاف المقدَّرة بين إحداثي الإدخال ونتيجة المناطق:"NEAR"
هي العلاقة التلقائية عندما لا ينطبق أيّ مما يلي."WITHIN"
عندما تكون إحداثية الإدخال قريبة من مركز المنطقة"OUTSKIRTS"
عندما يكون الإحداثي الذي يتم إدخاله قريبًا من حافة المنطقة
التغطية
تتوفّر أوصاف العناوين في جميع المناطق. اطّلِع على منطقة coverage لمعرفة التفاصيل.
ملاحظات
هذه ميزة تجريبية ونشكرك على تقديم ملاحظاتك. يُرجى مراسلتنا عبر البريد الإلكتروني على العنوان address-descriptors-feedback@google.com.