بررسی اجمالی

پلتفرم را انتخاب کنید: سرویس وب جاوا اسکریپت اندروید iOS
Places API سرویسی است که درخواست های HTTP برای داده های مکان را از طریق روش های مختلف می پذیرد. داده‌های مکان قالب‌بندی شده و تصاویر مربوط به مؤسسات، مکان‌های جغرافیایی یا نقاط برجسته مورد علاقه را برمی‌گرداند.

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

با انتشار Places API (جدید)، اولین وظیفه شما این است که تصمیم بگیرید از کدام مجموعه API استفاده کنید. این در صورتی صادق است که شما یک مشتری جدید یا یک مشتری موجود هستید که قبلاً از API ها استفاده می کنید. از این راهنما برای یادگیری تفاوت های کلیدی بین دو API استفاده کنید.

نحوه عملکرد Places API

Places API (جدید)

Places API (جدید) درخواست‌ها را به‌عنوان یک URL استاندارد با یک نقطه پایانی سرویس خاص، مانند /places یا places:searchText می‌پذیرد و یک پاسخ JSON را برمی‌گرداند. Places API (جدید) از مجوز توسط کلید API و نشانه OAuth پشتیبانی می کند. مثال زیر یک درخواست Place Details برای برگرداندن اجزای آدرس برای شناسه مکان با استفاده از یک کلید API ایجاد می کند:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

Places API

Places API درخواست‌ها را به‌عنوان یک URL استاندارد با یک نقطه پایانی سرویس خاص، مانند /place یا /photo می‌پذیرد. نقاط پایانی نیز نوع فرمت مشخص شده در درخواست، JSON یا XML را می پذیرند. درخواست سرویس از پارامترهای مربوط به آن نقطه پایانی خاص برای اصلاح داده های برگشتی استفاده می کند. مثال زیر یک درخواست Place Details برای برگرداندن اجزای آدرس برای شناسه مکان در فرمت JSON ایجاد می کند:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&fields=address_components&key=YOUR_API_KEY

در این مثال، سرویس از شناسه مکان ارائه شده برای یافتن مکان درخواستی و برگرداندن اجزای آدرس در قالب JSON استفاده می کند.

منابع

جدول زیر منابع موجود از طریق Places API را خلاصه می کند.

Places API Places API (جدید) توجه داشته باشید
مکان را پیدا کنید جستجوی متن (جدید) نسخه جدیدی از Find Place وجود ندارد. جستجوی متن (جدید) جایگزین آن شده است.
جستجوی نزدیک جستجوی نزدیک (جدید) همه درخواست‌هایی که از API موجود استفاده می‌کنند و شامل جستجوی متنی هستند باید از جستجوی متن (جدید) استفاده کنند زیرا جستجوی نزدیک (جدید) از ورودی متن پشتیبانی نمی‌کند.
جستجوی متن جستجوی متن (جدید)
جزئیات مکان جزئیات مکان (جدید)
عکس مکان عکس مکان (جدید)
محل تکمیل خودکار تکمیل خودکار (جدید) در پیش نمایش
پرس و جو تکمیل خودکار تکمیل خودکار (جدید) قابلیت‌های اضافه شده به نسخه پیش‌نمایش تکمیل خودکار (جدید)

نحوه استفاده از Places API

مراحل زیر یک سناریوی مورد استفاده معمولی برای استفاده از سرویس Places API را پوشش می دهد. همانطور که راه حل خود را ایجاد می کنید، می توانید از نقاط پایانی اضافی مانند جستجوی نزدیک و عکس های مکان استفاده کنید.
1 راه اندازی را دریافت کنید با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید و سپس نحوه استفاده از کلید API خود را بیاموزید. برای Places API (جدید)، می‌توانید از نشانه‌های OAuth نیز استفاده کنید.
2 یک جستجوی متنی اولیه را امتحان کنید با استفاده از جستجوی متن (جدید) یا جستجوی متن، یک جستجوی متنی ساده صادر کنید.
3 برای جزئیات بیشتر از شناسه مکان استفاده کنید بسیاری از API های پلتفرم نقشه های گوگل، شناسه مکان را به عنوان بخشی از پاسخ برمی گردانند. از شناسه مکان برای دریافت جزئیات یک مکان استفاده کنید. جزئیات مکان (جدید) و جزئیات مکان را ببینید.
4 برای یک مکان عکس بگیرید سرویس عکس مکان به شما امکان دسترسی به میلیون ها عکس ذخیره شده در پایگاه داده Places را می دهد. از عکس مکان (جدید) یا جزئیات مکان برای دسترسی به عکس‌های یک مکان استفاده کنید.