Method: resolveMapsUrls

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

طلب HTTP

POST https://mapstools.googleapis.com/v1: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.

نص الاستجابة

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

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

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

object (Entity)

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

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

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

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

string

النتائج فقط. رابط لحفظ جميع الكيانات التي تم حلّها بنجاح في "خرائط Google"

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

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

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