درباره Places API (جدید)

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

مقدمه

‫Places API (جدید) شامل میاناهای برنامه‌سازی کاربردی زیر است:

این سند حاوی نمای کلی این میاناهای برنامه‌سازی کاربردی جدید است.

جزئیات جا (جدید)

شناسه مکان به‌طور منحصربه‌فرد مکانی را در پایگاه داده Google Places و در Google Maps شناسایی می‌کند. با شناسه جا، می‌توانید با شروع درخواست جزئیات جا (جدید)، جزئیات مربوط به یک مؤسسه یا مکان جالب خاص را درخواست کنید. درخواست «جزئیات جا (جدید)» اطلاعات جامعی درباره مکان مشخص‌شده برمی‌گرداند، مانند نشانی کامل، شماره تلفن، رده‌بندی کاربر، و مرورها.

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

Place Photos (New)

عکس‌های مکان (جدید) به شما امکان می‌دهد با دسترسی به میلیون‌ها عکس ذخیره‌شده در پایگاه داده Google Places، محتوای عکاسی با کیفیت بالا را به برنامه‌تان اضافه کنید. بااستفاده از Place Photos (New) API، می‌توانید به عکس‌ها دسترسی پیدا کنید و اندازه تصویر را به اندازه بهینه برای برنامه‌تان تغییر دهید.

همه درخواست‌ها به Place Photos (New) API باید شامل نام منبع عکس باشد که به‌طور منحصربه‌فرد عکس را برای برگرداندن شناسایی می‌کند. می‌توانید نام منبع عکس را بااستفاده از این مورد دریافت کنید:

برای گنجاندن نام منبع عکس در پاسخ از درخواست «جزئیات جا (جدید)»، «جستجوی نوشتار (جدید)»، یا «جستجوی اطراف (جدید)»، مطمئن شوید که فیلد photos را در ماسک فیلد درخواست گنجانده‌اید.

Places API (New) شامل دو میانای برنامه‌سازی کاربردی جستجو است:

  • جستجوی نوشتار (جدید)

    به شما امکان می‌دهد رشته نوشتاری را برای جستجوی مکان مشخص کنید. برای مثال: «غذای گیاهی تند در سیدنی، استرالیا» یا «غذای دریایی عالی نزدیک پالو آلتو، کالیفرنیا».

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

  • جستجوی اطراف (جدید)

    به شما امکان می‌دهد منطقه‌ای را برای جستجو به‌همراه فهرستی از انواع مکان‌ها مشخص کنید. منطقه را به‌صورت دایره‌ای مشخص کنید که با مختصات طول و عرض جغرافیایی نقطه مرکزی و شعاع به متر تعریف شده است.

    یک یا چند نوع مکان را که مشخصه‌های مکان را تعریف می‌کند مشخص کنید. برای مثال، «pizza_restaurant» و «shopping_mall» را مشخص کنید تا پیتزافروشی واقع در مرکز خریدی در منطقه مشخص‌شده جستجو شود.

تفاوت اصلی بین این دو جستجو این است که «جستجوی نوشتار (جدید)» به شما امکان می‌دهد رشته جستجوی دلخواهی را مشخص کنید، درحالی‌که «جستجوی اطراف (جدید)» به منطقه خاصی برای جستجو نیاز دارد.

تکمیل خودکار (جدید) و کدهای جلسه

تکمیل خودکار (جدید) سرویسی وب است که پیش‌بینی‌های مکان و پیش‌بینی‌های پُرسمان را در پاسخ به درخواست HTTP برمی‌گرداند. در درخواست، رشته جستجوی نوشتاری و مرزهای جغرافیایی را که ناحیه جستجو را کنترل می‌کند مشخص کنید.

کدهای جلسه رشته‌های تولیدشده توسط کاربر هستند که تماس‌های «تکمیل خودکار (جدید)» را به‌عنوان جلسه ردیابی می‌کنند. «تکمیل خودکار (جدید)» از کد جلسه برای گروه‌بندی مراحل پُرسمان و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صورت‌حساب استفاده می‌کند.

فیلدها، مشخصه‌ها، و گزینه‌های دسترس‌پذیری جدید

Places API (New) شامل فیلدها، مشخصه‌ها، و گزینه‌های دسترس‌پذیری جدیدی است تا اطلاعات بیشتری درباره مکان‌ها به کاربران ارائه دهد. این جنبه‌ها در بخش‌های زیر شرح داده شده‌اند.

فیلدها

‫Places API (جدید) شامل چندین فیلد جدید است:

فیلد شرح
regularSecondaryOpeningHours زمان‌های خاصی را برای عملیات‌های مشخصی توصیف می‌کند. ساعت کاری ثانویه با ساعت کاری اصلی کسب‌وکار متفاوت است. برای نمونه، رستوران می‌تواند ساعت‌های بگیر و بران یا ساعت‌های ارسال را به‌عنوان ساعت‌های ثانویه خود مشخص کند.
paymentOptions گزینه‌های پرداختی که مکان می‌پذیرد. مکان می‌تواند بیش‌از یک گزینه پرداخت را بپذیرد. اگر داده‌های گزینه پرداخت دردسترس نباشد، فیلد گزینه پرداخت تنظیم نخواهد شد. گزینه‌ها شامل موارد زیر است:
  • کارت اعتباری
  • کارت نقدی
  • فقط پرداخت نقدی
  • پرداخت با NFC
parkingOptions گزینه‌های پارکینگ ارائه‌شده توسط مکان. گزینه‌ها شامل موارد زیر است:
  • پارکینگ رایگان
  • پارکینگ‌های روباز پولی
  • پارکینگ رایگان کنار خیابان
  • پارکینگ با پیشکار
  • پارکینگ رایگان در گاراژ
  • پارکینگ پولی در گاراژ
subDestinations مکان‌های منحصربه‌فردی که به مکان خاصی مرتبط هستند. برای مثال، پایانه‌های فرودگاه به‌عنوان مقصد فرعی فرودگاه درنظر گرفته می‌شوند.
fuelOptions جدیدترین اطلاعات درباره گزینه‌های سوخت دردسترس در پمپ بنزین. این اطلاعات به‌طور مرتب به‌روزرسانی می‌شود. گزینه‌ها شامل موارد زیر است:
  • گازوئيل
  • بدون سرب معمولی
  • متوسط
  • ممتاز
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • متان
  • زیست‌دیزل
  • گازوئیل کامیون
evChargeOptions تعداد شارژرهای خودرو برقی (EV) در این ایستگاه. درحالی‌که برخی‌از شارژرهای خودرو برقی چندین رابط دارند، هر شارژر می‌تواند فقط یک خودرو را در هر زمان شارژ کند؛ درنتیجه، این فیلد نشان‌دهنده تعداد شارژرهای خودرو برقی دردسترس در زمان مشخصی است.
shortFormattedAddress نشانی کوتاه و قابل‌خواندن برای انسان برای یک مکان.
primaryType نوع اصلی نتیجه ارائه‌شده. برای مثال، ممکن است مکانی به‌عنوان cafe یا airport طبقه‌بندی شود. هر مکان فقط می‌تواند یک نوع اصلی داشته باشد. برای فهرست کامل مقادیر ممکن، انواع پشتیبانی‌شده را ببینید.
primaryTypeDisplayName نام نمایشی نوع اصلی، بومی‌سازی‌شده به زبان درخواست درصورت وجود. برای فهرست کامل مقادیر ممکن، انواع پشتیبانی‌شده را ببینید.
entrances ورودی‌های مقصد. ورودی یک جفت مختصات عرض جغرافیایی/طول جغرافیایی است که مکان نقطه ورود و خروج را برای یک مکان تعریف می‌کند.
navigationPoints نقاط ناوبری برای مقصد. نقطه ناوبری مکانی در کنار جاده است که ناوبری می‌تواند در آنجا پایان یابد، ازجمله حالت‌های سفر و کاربردهای پشتیبانی‌شده.

مشخصه‌ها

‫Places API (جدید) شامل چندین مشخصه جدید است:

مشخصه شرح
outdoorSeating مکان جای نشستن در فضای باز دارد.
liveMusic این مکان موسیقی زنده ارائه می‌دهد.
menuForChildren این مکان منو کودک دارد.
servesCocktails در این مکان کوکتل سرو می‌شود.
servesDessert این مکان دسر سرو می‌کند.
servesCoffee این مکان قهوه سرو می‌کند.
goodForChildren مکان برای کودکان مناسب است.
allowsDogs ورود سگ به این مکان مجاز است.
restroom این مکان سرویس بهداشتی دارد.
goodForGroups مکان برای گروه‌ها مناسب است.
goodForWatchingSports این مکان برای تماشای رویدادهای ورزشی مناسب است.

گزینه‌های دسترس‌پذیری

Places API (New) شامل فیلدهای گزینه دسترس‌پذیری زیر است:

فیلد شرح
wheelchairAccessibleParking مکان پارکینگ دسترس‌پذیر با صندلی چرخدار ارائه می‌دهد.
wheelchairAccessibleEntrance مکان ورودی دسترس‌پذیر با صندلی چرخدار دارد.
wheelchairAccessibleRestroom مکان توالت دسترس‌پذیر با صندلی چرخدار دارد.
wheelchairAccessibleSeating مکان جای نشستن دسترس‌پذیر با صندلی چرخدار دارد.

خلاصه‌های تولیدشده با هوش مصنوعی

خلاصه‌های تولیدشده با هوش مصنوعی Places API (جدید) از قابلیت‌های مدل Gemini برای برگرداندن خلاصه‌هایی درباره مکان‌ها و مناطقی استفاده می‌کند که می‌تواند به کاربران کمک کند تصمیم بگیرند کجا بروند.

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

ویژگی‌های مبتنی بر هوش مصنوعی به Places API (جدید) اضافه شد

خلاصه‌های با بهره‌گیری از هوش مصنوعی توسط جزئیات جا (جدید)، جستجوی نوشتار (جدید)، و جستجوی اطراف (جدید) پشتیبانی می‌شود. خلاصه‌های زیر که با بهره‌گیری از هوش مصنوعی تولید شده‌اند در پاسخ‌های Places API (جدید) دردسترس هستند:

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

Google این خلاصه‌ها را به‌طور مکرر بازتولید می‌کند تا مطمئن شود که براساس جدیدترین اطلاعات دردسترس، تازه هستند. وقتی درخواست Places API (جدید) می‌دهید، جدیدترین داده‌ها را در برنامه‌تان نمایش خواهید داد.

انتقال به Places API (جدید)

اگر مشتری فعلی Places API (قدیمی) هستید و می‌خواهید برنامه‌تان را برای استفاده از Places API (جدید) انتقال دهید، مستندات انتقال زیر را ببینید: