تتضمّن أوصاف العناوين معلومات إضافية تساعد في وصف موقع جغرافي باستخدام المَعالم والمناطق. يمكنك الاطّلاع على العرض التوضيحي لأوصاف العناوين لاستكشاف الميزة.
المَعلمات الإضافية
يمكن تفعيل أوصاف العناوين من خلال استخدام المَعلمة 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"عندما تكون الإحداثية المُدخَلة قريبة من حافة المنطقة
التغطية
تتوفّر أوصاف العناوين في جميع المناطق. لمزيد من التفاصيل، يمكنك الاطّلاع على نطاق المنطقة.
الملاحظات
تتوفّر هذه الميزة في جميع المناطق، وهي متاحة بشكل عام في الهند، وفي مرحلة الإطلاق التجريبي لمرحلة ما قبل التوفّر للجمهور العام في جميع المناطق الأخرى. يسرّنا تلقّي ملاحظاتك. يُرجى الإبلاغ عن الخطأ في أداة تتبُّع المشاكل.