Places API (New)

API مکان‌ها به توسعه‌دهندگان اجازه می‌دهد تا به نقاط پایانی جستجو و بازیابی متنوعی برای یک مکان دسترسی داشته باشند.

• منبع REST: v1.places
• منبع REST: v1.places.photos

سرویس: places.googleapis.com

برای فراخوانی این سرویس، توصیه می‌کنیم کتابخانه Places را با استفاده از Maps JavaScript API بارگذاری کنید یا از کتابخانه‌های کلاینت ارائه شده توسط گوگل استفاده کنید. اگر برنامه شما برای فراخوانی این سرویس نیاز به استفاده از کتابخانه‌های خودتان دارد، هنگام ارسال درخواست‌های API از اطلاعات زیر استفاده کنید.

سند کشف

یک سند کشف ، مشخصاتی قابل خواندن توسط ماشین برای توصیف و استفاده از APIهای REST است. از آن برای ساخت کتابخانه‌های کلاینت، افزونه‌های IDE و سایر ابزارهایی که با APIهای گوگل تعامل دارند، استفاده می‌شود. یک سرویس ممکن است چندین سند کشف ارائه دهد. این سرویس سند کشف زیر را ارائه می‌دهد:

• https://places.googleapis.com/$discovery/rest?version=v1

نقطه پایانی سرویس

یک نقطه پایانی سرویس ، یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و تمام URI های زیر نسبت به این نقطه پایانی سرویس هستند:

• https://places.googleapis.com

منبع REST: v1.places

روش‌ها
autocomplete	POST /v1/places:autocomplete پیش‌بینی‌ها را برای ورودی داده شده برمی‌گرداند.
get	GET /v1/{name=places/*} جزئیات یک مکان را بر اساس نام منبع آن، که رشته‌ای با فرمت places/{place_id} است، دریافت کنید.
searchNearby	POST /v1/places:searchNearby جستجوی مکان‌های نزدیک به مکان‌های مورد نظر.
searchText	POST /v1/places:searchText جستجوی مکان مبتنی بر جستجوی متنی

منبع REST: v1.places.photos

روش‌ها
getMedia	GET /v1/{name=places/*/photos/*/media} یک رسانه عکس با رشته مرجع عکس تهیه کنید.