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

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

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

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

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