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

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

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

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