Method: resolveMapsUrls

فهرستی از نشانی‌های وب Google Maps را به نهادهای زمین‌مکانی خاص (مثلاً مکان‌ها) در Google Maps تبدیل می‌کند.

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

متن درخواست

بدنه درخواست حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "urls": [
    string
  ]
}
فیلدها
urls[]

string

الزامی. نشانی‌های وب Google Maps که باید حل‌وفصل شوند. هر نشانی وب باید نشانی وب معتبر Google Maps باشد، برای مثال، https://maps.app.goo.gl/...، https://www.google.com/maps/place/...، یا https://maps.google.com/.... درحال‌حاضر، فقط نشانی‌های وبی که به یک مکان اشاره می‌کنند پشتیبانی می‌شوند. می‌توانید حداکثر ۲۰ نشانی وب مشخص کنید.

بدنه پاسخ

پیام پاسخ برای v1.resolveMapsUrls.

درصورت موفقیت‌آمیز بودن، بدنه پاسخ حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
فیلدها
entities[]

object (Entity)

فقط خروجی. فهرست نهادهای حل‌شده از نشانی‌های وب Google Maps. تضمین می‌شود که با نمایه‌های urls درخواست، نگاشت ۱:۱ داشته باشد. پیام خالی در نمایه i (که در آن هیچ entity تنظیم نشده است) نشان می‌دهد که تجزیه برای آن نشانی وب ناموفق بوده است. اگر حل‌وفصل ناموفق بود، لطفاً فیلد failedRequests را برای وضعیت خطا بررسی کنید.
failedRequests

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

فقط خروجی. نقشه‌ای که خرابی‌های جزئی را برای نشانی‌های وب Google Maps نشان می‌دهد. کلید، نمایه درخواست ناموفق در فیلد urls است. این مقدار وضعیت خطایی است که جزئیات دلیل ناموفق بودن وضوح را نشان می‌دهد.

شیئی که حاوی فهرستی از جفت‌های "key": value است. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
saveToMapsUrl

string

فقط خروجی. پیوندی برای ذخیره کردن همه نهادهای باموفقیت حل‌شده در Google Maps.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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