Method: resolveMapsUrls

تحوّل هذه الطريقة قائمة بعناوين URL على "خرائط Google" إلى كيانات جغرافية مكانية محدّدة (مثل الأماكن) على "خرائط Google".

طلب HTTP

POST https://mapstools.googleapis.com/v1alpha:resolveMapsUrls

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "urls": [
    string
  ]
}
الحقول
urls[]

string

الحقل مطلوب. عناوين URL التي سيتم تحليلها في "خرائط Google" يجب أن يكون كل عنوان URL صالحًا على "خرائط Google"، مثل https://maps.app.goo.gl/... أو https://www.google.com/maps/place/... أو https://maps.google.com/.... في الوقت الحالي، لا تتوفّر سوى عناوين URL التي تشير إلى مكان واحد. يمكنك تحديد ما يصل إلى 20 عنوان URL.

نص الاستجابة

رسالة الردّ على v1alpha.resolveMapsUrls

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
الحقول
entities[]

object (Entity)

النتائج فقط. قائمة العناصر التي تم حلّها من عناوين URL الخاصة بـ "خرائط Google". من المؤكّد أنّها تتطابق مع فهارس الطلب urls بنسبة 1:1. تشير الرسالة الفارغة في الفهرس i (حيث لم يتم ضبط entity) إلى تعذُّر تحديد عنوان URL هذا. في حال تعذُّر إكمال عملية التحويل، يُرجى التحقّق من الحقل failedRequests لمعرفة حالة الخطأ.
failedRequests

map (key: integer, value: object (Status))

النتائج فقط. خريطة تعرض حالات تعذّر جزئي لعناوين URL في "خرائط Google". المفتاح هو فهرس الطلب الذي تعذّر تنفيذه في الحقل urls. القيمة هي حالة الخطأ التي توضّح سبب تعذُّر إكمال عملية التحويل.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/maps-platform.mapstools