مقدمه
Places API سرویسی است که درخواست‌های اچ‌تی‌تی‌پی برای داده‌های مکان را ازطریق روش‌های مختلف می‌پذیرد. این سرویس داده‌های مکان قالب‌بندی‌شده و تصاویر مربوط به مؤسسات، مکان‌های جغرافیایی، یا نقاط موردعلاقه برجسته را برمی‌گرداند.چرا از Places API (جدید) استفاده کنیم
ویژگی‌های مکان‌آگاه ایجاد کنید تا داده‌های مکان دقیق را برای کاربران دردسترس قرار دهید. داده‌های دردسترس ازطریق میانای برنامه‌سازی کاربردی «مکان‌ها» (جدید) براساس یکی از دقیق‌ترین، به‌روزترین، و جامع‌ترین مدل‌های مکان در دنیای واقعی ساخته شده است. در اینجا چند نمونه از موارد استفاده برای برنامه‌ها آورده شده است:
- نمایش اجاره‌های آپارتمان در مناطق کلان‌شهری بزرگ با نتایجی که به‌طور خاص شهرها را هدف‌یابی می‌کنند.
- جزئیات مکان را در به‌روزرسانی وضعیت تحویل یا ارسال اضافه کنید.
- فهرستی از پارک‌های یک منطقه را به‌همراه عکس‌ها و مرورهای ارسالی کاربران نمایش می‌دهد.
- اطلاعات تماس، مرورها، و سطوح قیمت را برای مؤسسات درطول مسیر دراختیار افرادی که درحال برنامه‌ریزی سفر هستند قرار دهید.
با «میانای برنامه‌سازی کاربردی مکان‌ها (جدید)» چه کارهایی می‌توانید انجام دهید
می‌توانید از Places API (جدید) برای گنجاندن ویژگی‌های زیر در برنامه‌هایتان استفاده کنید:
- نتایج جستجوی مکان را از انواع مختلف پُرسمان‌های کاربر ارائه دهید، مثل ورودی نوشتاری، مکان‌های اطراف، و پُرسمان‌های کاربر مبهم یا دسته‌بندی‌شده.
- ویژگی‌های تکمیل خودکار را برای انواع مختلف جستجو، چه پُرسمان‌های نوشتاری خاص یا پُرسمان‌های دسته‌ای، فعال کنید.
- نوع جزئیات برگردانده‌شده درباره مکان را پالایش کنید، مثلاً ساعت کاری، خلاصه، مرورهای کاربر، و عکس.
- عکس‌های با کیفیت بالا به مکان‌هایی که برنامه‌تان ارائه می‌دهد اضافه کنید.
بسیاری از میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps» از شناسه‌های جا پشتیبانی می‌کنند، که شناسه جا به‌طور منحصربه‌فرد مکانی را در پایگاه داده Google Places و در Google Maps شناسایی می‌کند. روش‌های زیادی برای دریافت شناسه مکان وجود دارد، ازجمله از Places API (جدید)، و همچنین از Geocoding API، Routes API، و Address Validation API.
وقتی شناسه مکان را دریافت کردید، می‌توانید از Places API (جدید) برای درخواست جزئیات بیشتر درباره یک مؤسسه یا نقطه موردعلاقه خاص، مانند نشانی کامل، شماره تلفن، رده‌بندی کاربر، و مرورها استفاده کنید.
نحوه عملکرد Places API (جدید)
Places API (جدید) درخواست‌ها را به‌عنوان نشانی وب استاندارد با نقطه پایانی سرویس خاصی مثل /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 را پوشش می‌دهد. همان‌طور که راه‌حل خود را می‌سازید، می‌توانید از نقاط پایانی اضافی، مانند «جستجوی اطراف» (جدید) و «عکس‌های مکان» (جدید) استفاده کنید.| ۱ | راه‌اندازی کنید | صورت‌حساب را راه‌اندازی کنید، «میانای برنامه‌سازی کاربردی مکان‌ها» (جدید) را فعال کنید، و اولین درخواستتان را ارسال کنید. |
| ۲ | جستجوی نوشتاری ساده را امتحان کنید | بااستفاده از جستجوی نوشتاری (جدید)، جستجوی نوشتاری انجام دهید. |
| 3 | برای جزئیات بیشتر از شناسه مکان استفاده کنید | بسیاری از «میاناهای برنامه‌سازی کاربردی پلاتفرم Google Maps» شناسه مکان را به‌عنوان بخشی از پاسخ برمی‌گردانند. از شناسه‌های مکان برای دریافت جزئیات مکان (جدید) استفاده کنید. |
| ۴ | دریافت عکس برای مکان | «عکس‌های مکان» (جدید) به شما امکان می‌دهد به میلیون‌ها عکس ذخیره‌شده در پایگاه داده «مکان‌ها» دسترسی داشته باشید. از عکس‌های مکان (جدید) برای دسترسی به عکس‌های مکان استفاده کنید. |