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