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