چرا از 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 | برای یک مکان عکس بگیرید | Place Photos (جدید) به شما امکان می دهد به میلیون ها عکس ذخیره شده در پایگاه داده Places دسترسی داشته باشید. از عکسهای مکان (جدید) برای دسترسی به عکسهای یک مکان استفاده کنید. |