Method: places.get

جزئیات یک مکان را بر اساس نام منبع آن، که رشته‌ای با فرمت places/{placeId} است، دریافت کنید.

درخواست HTTP

GET https://places.googleapis.com/v1/{name=places/*}

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

پارامترهای مسیر

پارامترها
name

string

الزامی. نام منبع یک مکان، با فرمت places/{placeId} .

پارامترهای پرس و جو

پارامترها
languageCode

string

اختیاری. جزئیات مکان در صورت وجود با زبان دلخواه نمایش داده خواهد شد.

فهرست فعلی زبان‌های پشتیبانی‌شده: https://developers.google.com/maps/faq#languagesupport .

regionCode

string

اختیاری. کد یونیکد کشور/منطقه (CLDR) مکانی که درخواست از آنجا می‌آید. این پارامتر برای نمایش جزئیات مکان، مانند نام مکان خاص منطقه، در صورت وجود، استفاده می‌شود. این پارامتر می‌تواند بر اساس قانون مربوطه بر نتایج تأثیر بگذارد. برای اطلاعات بیشتر، به https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html مراجعه کنید.

توجه داشته باشید که کدهای منطقه ای سه رقمی در حال حاضر پشتیبانی نمی شوند.

sessionToken

string

اختیاری. رشته‌ای که یک جلسه تکمیل خودکار را برای اهداف صورتحساب مشخص می‌کند. باید یک رشته base64 ایمن برای URL و نام فایل با حداکثر ۳۶ کاراکتر ASCII باشد. در غیر این صورت خطای INVALID_ARGUMENT بازگردانده می‌شود.

جلسه زمانی شروع می‌شود که کاربر شروع به تایپ یک پرس‌وجو می‌کند و زمانی که مکانی را انتخاب می‌کند و فراخوانی برای جزئیات مکان یا اعتبارسنجی آدرس انجام می‌شود، پایان می‌یابد. هر جلسه می‌تواند چندین پرس‌وجو داشته باشد و به دنبال آن یک درخواست جزئیات مکان یا اعتبارسنجی آدرس قرار گیرد. اعتبارنامه‌های استفاده شده برای هر درخواست در یک جلسه باید متعلق به همان پروژه کنسول ابری گوگل باشد. پس از پایان یک جلسه، توکن دیگر معتبر نیست؛ برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر sessionToken حذف شود، یا اگر از یک توکن جلسه دوباره استفاده کنید، هزینه جلسه طوری محاسبه می‌شود که انگار هیچ توکن جلسه‌ای ارائه نشده است (هزینه هر درخواست جداگانه محاسبه می‌شود).

ما دستورالعمل‌های زیر را توصیه می‌کنیم:

  • از توکن‌های جلسه برای همه فراخوانی‌های تکمیل خودکار مکان استفاده کنید.
  • برای هر جلسه یک توکن جدید ایجاد کنید. استفاده از UUID نسخه ۴ توصیه می‌شود.
  • اطمینان حاصل کنید که اعتبارنامه‌های مورد استفاده برای همه درخواست‌های تکمیل خودکار مکان، جزئیات مکان و اعتبارسنجی آدرس در یک جلسه متعلق به یک پروژه Cloud Console هستند.
  • حتماً برای هر جلسه جدید، یک توکن جلسه منحصر به فرد ارسال کنید. استفاده از یک توکن برای بیش از یک جلسه منجر به این می‌شود که برای هر درخواست، هزینه جداگانه محاسبه شود.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

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

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

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

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform