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
  • https://www.googleapis.com/auth/cloud-platform.read-only