مقدمه
Places API (جدید) شامل میاناهای برنامهسازی کاربردی زیر است:
این سند حاوی نمای کلی این میاناهای برنامهسازی کاربردی جدید است.
جزئیات جا (جدید)
شناسه مکان بهطور منحصربهفرد مکانی را در پایگاه داده Google Places و در Google Maps شناسایی میکند. با شناسه جا، میتوانید با شروع درخواست جزئیات جا (جدید)، جزئیات مربوط به یک مؤسسه یا مکان جالب خاص را درخواست کنید. درخواست «جزئیات جا (جدید)» اطلاعات جامعی درباره مکان مشخصشده برمیگرداند، مانند نشانی کامل، شماره تلفن، ردهبندی کاربر، و مرورها.
راههای زیادی برای دریافت شناسه مکان وجود دارد. میتوانید از این موارد استفاده کنید:
- جستجوی نوشتار (جدید)
- جستجوی اطراف (جدید)
- Geocoding API
- میانای برنامهسازی کاربردی Routes
- Address Validation API
- تکمیل خودکار (جدید)
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 |
گزینههای پرداختی که مکان میپذیرد. مکان میتواند بیشاز یک گزینه پرداخت را بپذیرد. اگر دادههای گزینه پرداخت دردسترس نباشد،
فیلد گزینه پرداخت تنظیم نخواهد شد. گزینهها شامل موارد زیر است:
|
parkingOptions |
گزینههای پارکینگ ارائهشده توسط مکان. گزینهها شامل موارد زیر است:
|
subDestinations |
مکانهای منحصربهفردی که به مکان خاصی مرتبط هستند. برای مثال، پایانههای فرودگاه بهعنوان مقصد فرعی فرودگاه درنظر گرفته میشوند. |
fuelOptions |
جدیدترین اطلاعات درباره گزینههای سوخت دردسترس در
پمپ بنزین. این اطلاعات بهطور مرتب بهروزرسانی میشود. گزینهها شامل
موارد زیر است:
|
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 (جدید) انتقال دهید، مستندات انتقال زیر را ببینید:
- انتقال به «جزئیات جا» (جدید)
- انتقال به «جستجوی اطراف» (جدید)
- انتقال به «جستجوی نوشتار» (جدید)
- انتقال به «عکسهای مکان» (جدید)
- انتقال به «تکمیل خودکار» (جدید)