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