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

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

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

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

يمكن تفعيل واصفات العناوين من خلال استخدام المَعلمة 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" عندما تكون الإحداثيات المُدخلة قريبة من حافة المنطقة.

التغطية

تتوفّر أوصاف العناوين في جميع المناطق. لمزيد من التفاصيل، يُرجى الاطّلاع على تغطية المنطقة.

الملاحظات

تتوفّر هذه الميزة في جميع المناطق، وهي متاحة للجميع في الهند، وفي مرحلة الإطلاق التجريبي قبل إتاحتها للجميع في جميع المناطق الأخرى. ونودّ تلقّي ملاحظاتك. يُرجى الإبلاغ عن الخطأ في أداة تتبُّع المشاكل.