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