Method: resolveMapsUrls

فهرستی از آدرس‌های اینترنتی نقشه‌های گوگل را به موجودیت‌های جغرافیایی خاص (مثلاً مکان‌ها) در نقشه‌های گوگل تبدیل می‌کند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

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

string

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

بدنه پاسخ

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

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

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

object ( Entity )

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

failedRequests

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

فقط خروجی. نقشه‌ای که خرابی‌های جزئی را برای URLهای نقشه‌های گوگل گزارش می‌دهد. کلید، اندیس درخواست ناموفق در فیلد 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