مقدمه
API مکانها سرویسی است که درخواستهای HTTP برای دادههای مکانی را از طریق روشهای مختلف میپذیرد. این API دادههای مکانی قالببندیشده و تصاویر مربوط به مؤسسات، مکانهای جغرافیایی یا نقاط برجسته مورد علاقه را برمیگرداند.چرا از Places API استفاده کنیم (جدید)
ویژگیهای آگاه از موقعیت مکانی ایجاد کنید تا دادههای مکانی دقیق را در دسترس کاربران خود قرار دهید. دادههای موجود از طریق Places API (جدید) بر اساس یکی از دقیقترین، بهروزترین و جامعترین مدلهای مکانی دنیای واقعی ساخته شدهاند. در اینجا مثالهایی از موارد استفاده برای برنامهها آورده شده است:
- اجاره آپارتمان در مناطق شهری بزرگ را با نتایجی که به طور خاص شهرها را هدف قرار میدهند، نمایش دهید.
- جزئیات مکان را در بهروزرسانی وضعیت تحویل یا دریافت کالا لحاظ کنید.
- فهرستی از پارکهای یک منطقه را به همراه عکسها و نظرات ارسالی کاربران نمایش دهید.
- اطلاعات تماس، نظرات و سطح قیمت اقامتگاههای بین راهی را در اختیار افرادی که قصد سفر دارند قرار دهید.
با Places API چه کارهایی میتوانید انجام دهید (جدید)
شما میتوانید از Places API (جدید) برای اضافه کردن ویژگیهای زیر به برنامههای خود استفاده کنید:
- نتایج جستجوی مکان را از انواع مختلف درخواستهای کاربران، مانند ورودی متن، مکانهای نزدیک و درخواستهای مبهم یا طبقهبندیشده کاربر، ارائه دهید.
- ویژگیهای تکمیل خودکار را برای انواع مختلف جستجو، چه برای پرسوجوهای متنی خاص و چه برای پرسوجوهای دستهبندیشده، فعال کنید.
- نوع جزئیاتی که در مورد یک مکان، مانند ساعات کاری، خلاصه، نظرات کاربران و عکس، برگردانده میشود را اصلاح کنید.
- عکسهای با کیفیت بالا را به مکانهایی که توسط برنامه شما ارائه میشوند اضافه کنید.
بسیاری از APIهای پلتفرم نقشههای گوگل از شناسههای مکان پشتیبانی میکنند، که در آن شناسه مکان به طور منحصر به فرد یک مکان را در پایگاه داده Google Places و در نقشههای گوگل مشخص میکند. روشهای زیادی برای به دست آوردن شناسه مکان وجود دارد، از جمله از طریق Places API (جدید)، و همچنین از طریق Geocoding API ، Routes API و Address Validation API .
وقتی یک شناسه مکان (place ID) داشته باشید، میتوانید از Places API (جدید) برای درخواست جزئیات بیشتر در مورد یک مکان یا نقطه مورد علاقه خاص، مانند آدرس کامل، شماره تلفن، امتیاز کاربران و نظرات کاربران، استفاده کنید.
نحوه عملکرد API مکانها (جدید)
API مکانها (جدید) درخواستها را به عنوان یک URL استاندارد با یک نقطه پایانی سرویس خاص، مانند /places یا places:searchText ، میپذیرد و یک پاسخ JSON برمیگرداند. API مکانها (جدید) از احراز هویت توسط کلید API و توکن OAuth پشتیبانی میکند. مثال زیر یک درخواست جزئیات مکان (جدید) برای بازگرداندن اجزای آدرس برای یک شناسه مکان با استفاده از یک کلید API ایجاد میکند:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
نحوه استفاده از API مکانها (جدید)
مراحل زیر یک سناریوی مورد استفاده معمول برای استفاده از سرویس Places API را پوشش میدهد. همزمان با ساخت راهکار خود، میتوانید از نقاط پایانی اضافی مانند جستجوی نزدیک (جدید) و عکسهای مکان (جدید) استفاده کنید.| ۱ | راهاندازی شوید | صورتحساب را تنظیم کنید ، API مکانها (جدید) را فعال کنید و اولین درخواست خود را ارسال کنید. |
| ۲ | یک جستجوی متنی ساده را امتحان کنید | با استفاده از جستجوی متن (جدید)، جستجوی متن را انجام دهید. |
| ۳ | برای جزئیات بیشتر از شناسه مکان استفاده کنید | بسیاری از APIهای پلتفرم نقشههای گوگل، شناسه مکان را به عنوان بخشی از پاسخ برمیگردانند. از شناسههای مکان برای دریافت جزئیات مکان استفاده کنید (جدید) . |
| ۴ | برای یک مکان عکس بگیرید | عکسهای مکان (جدید) به شما امکان دسترسی به میلیونها عکس ذخیره شده در پایگاه داده مکانها را میدهد. از عکسهای مکان (جدید) برای دسترسی به عکسهای یک مکان استفاده کنید. |