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