طلب أدوات وصف العناوين والردّ عليها

المطوّرون في المنطقة الاقتصادية الأوروبية

تتضمّن أوصاف العناوين معلومات إضافية تساعد في وصف موقع جغرافي باستخدام المَعالم والمناطق. يمكنك الاطّلاع على العرض التوضيحي الخاص بأوصاف العناوين لاستكشاف الميزة.

المَعلمات الإضافية

يمكن تفعيل أوصاف العناوين من خلال استخدام المَعلمة 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.