بررسی اجمالی

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

چرا از Places API استفاده کنید

ویژگی‌های آگاه از موقعیت مکانی را ایجاد کنید تا داده‌های مکان دقیق را به راحتی در دسترس کاربران خود قرار دهید. داده‌های موجود از طریق Places API بر اساس یکی از دقیق‌ترین، به‌روزترین و جامع‌ترین مدل‌های مکان در دنیای واقعی ساخته شده‌اند. در اینجا نمونه هایی از موارد استفاده برای برنامه ها آورده شده است:

  • کاندوهای اجاره‌ای در کلان‌شهرهای اصلی را با نتایجی که به‌طور خاص برای شهرها هدف‌گذاری شده است، نمایش دهید.
  • جزئیات مکان را در به‌روزرسانی وضعیت تحویل یا تحویل درج کنید.
  • نمایش لیستی از پارک ها در یک منطقه به همراه عکس ها و نظرات ارسال شده توسط کاربر.
  • به افرادی که برای سفر برنامه ریزی می کنند، اطلاعات تماس، نظرات و سطوح قیمت را برای موسسات در مسیر ارائه دهید.

با Places API چه کاری می توانید انجام دهید

می توانید از Places API برای گنجاندن ویژگی های زیر در برنامه های خود استفاده کنید:

  • نتایج جستجوی مکان را از انواع مختلف درخواست‌های کاربران، مانند ورودی متن، مکان‌های نزدیک، و جستارهای مبهم یا طبقه‌بندی شده کاربر ارائه دهید.
  • ویژگی های تکمیل خودکار را برای انواع مختلف جستجو، اعم از عبارت های متنی خاص یا جستارهای دسته بندی، فعال کنید.
  • نوع جزئیات بازگردانده شده درباره یک مکان، مانند ساعات کار، خلاصه، نظرات کاربران و یک عکس را اصلاح کنید.
  • عکس‌های باکیفیت را به مکان‌هایی که برنامه شما ارائه می‌کند اضافه کنید.

نحوه عملکرد 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 را به همراه داده هایی که برمی گرداند خلاصه می کند.

منابع داده داده ها برگردانده شد فرمت بازگشت
جستجوی مکان فهرستی از مکان‌ها را بر اساس مکان دستگاه یا رشته جستجو برمی‌گرداند.

جزئیات پاسخ‌های جستجوی مکان ، پاسخ‌های جستجوی نزدیک ، و پاسخ‌های جستجوی متنی را ببینید.

  • JSON
  • XML
جزئیات مکان اطلاعات دقیق‌تری درباره یک مکان خاص، از جمله نظرات کاربران، برمی‌گرداند.

جزئیات را در پاسخ‌های جزئیات مکان ببینید.

  • JSON
  • XML
عکس ها را قرار دهید دسترسی به میلیون‌ها عکس مرتبط با مکان را که در پایگاه داده Google Place ذخیره شده‌اند، فراهم می‌کند.

جزئیات پاسخ عکس‌های مکان را ببینید.

  • JSON
  • XML
محل تکمیل خودکار به طور خودکار نام و/یا آدرس یک مکان را هنگام تایپ کاربران پر می کند.

جزئیات مربوط به پاسخ‌های تکمیل خودکار مکان را ببینید.

  • JSON
  • XML
پرس و جو تکمیل خودکار یک سرویس پیش‌بینی پرس و جو را برای جستجوهای جغرافیایی مبتنی بر متن ارائه می‌کند، و هنگام تایپ کاربران، عبارت‌های پیشنهادی را برمی‌گرداند.

جزئیات پاسخ‌های تکمیل خودکار Query را ببینید.

  • JSON
  • XML

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

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

کتابخانه های مشتری موجود

این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:

Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های Google Maps، کتابخانه‌های مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.

بعدش چی