مقدمه
Places API (جدید) شامل میاناهای برنامه‌سازی کاربردی زیر است:
این سند حاوی نمای کلی این APIهای جدید است.
جزئیات جا (جدید)
شناسه مکان مکان را در پایگاه داده «مکان‌های Google» و در Google Maps به‌طور یکتا شناسایی می‌کند. با شناسه مکان، می‌توانید با شروع درخواست جزئیات مکان (جدید)، جزئیات مربوط به یک مؤسسه یا نقطه موردعلاقه خاص را درخواست کنید. درخواست «جزئیات مکان (جدید)» اطلاعات جامعی درباره مکان مشخص‌شده برمی‌گرداند، ازجمله نشانی کامل، شماره تلفن، رده‌بندی کاربر، و مرورها.
راه‌های زیادی برای دریافت شناسه مکان وجود دارد. می‌توانید از این موارد استفاده کنید:
- جستجوی نوشتاری (جدید)
- جستجوی اطراف (جدید)
- Geocoding API
- Routes API
- Address Validation API
- تکمیل خودکار (جدید)
Place Photos (جدید)
Place Photos (عکس‌های مکان) (جدید) به شما امکان می‌دهد با دسترسی به میلیون‌ها عکس ذخیره‌شده در پایگاه داده Google Places، محتوای عکاسی با کیفیت بالا به برنامه‌تان اضافه کنید. بااستفاده از Place Photos (جدید) 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 |
این مکان برای تماشای مسابقات ورزشی مناسب است. |
گزینه‌های دسترس‌پذیری
«ای‌پی‌آی مکان‌ها (جدید)» شامل فیلدهای گزینه دسترس‌پذیری زیر است:
| فیلد | شرح |
|---|---|
wheelchairAccessibleParking |
مکان پارکینگ دسترس‌پذیر با صندلی چرخدار ارائه می‌دهد. |
wheelchairAccessibleEntrance |
مکان ورودی دسترس‌پذیر با صندلی چرخدار دارد. |
wheelchairAccessibleRestroom |
مکان توالت دسترس‌پذیر با صندلی چرخدار دارد. |
wheelchairAccessibleSeating |
این مکان جای نشستن دسترس‌پذیر با صندلی چرخدار دارد. |
خلاصه‌های هوشواره‌ای
خلاصه‌های Places API (جدید) با بهره‌گیری از هوش مصنوعی از قابلیت‌های مدل Gemini استفاده می‌کند تا خلاصه‌هایی درباره مکان‌ها و مناطق ارائه دهد که می‌تواند به کاربران کمک کند تصمیم بگیرند کجا بروند.
خلاصه‌های تولیدشده با هوش مصنوعی داده‌ها را از ورودی‌های مختلف ترکیب می‌کنند تا به کاربران کمک کنند تصمیم‌های آگاهانه‌تری درباره مکان بگیرند. برای مثال، اگر درنظر دارید رستوران جدیدی را امتحان کنید، خلاصه با پشتیبانی هوش مصنوعی می‌تواند موارد برجسته منو را نمایان کند، به شما ایده بدهد، یا موضوعات را از مرورهای کاربر جمع‌آوری کند. اگر به شهر جدیدی سفر می‌کنید، خلاصه با پشتیبانی هوش مصنوعی می‌تواند نمایی کلی از جاذبه‌ها و امکانات رفاهی نزدیک ارائه دهد.
ویژگی‌های هوشواره‌ای به «میانای برنامه‌سازی کاربردی مکان‌ها» (جدید) اضافه شد
خلاصه‌های مجهز به هوش مصنوعی توسط جزئیات مکان (جدید)، جستجوی نوشتاری (جدید)، و جستجوی اطراف (جدید) پشتیبانی می‌شود. خلاصه‌های زیر که با بهره‌گیری از هوش مصنوعی تولید شده‌اند در پاسخ‌های Places API (جدید) دردسترس هستند:
- خلاصه‌های جا، که خلاصه‌های نمای کلی کوتاهی هستند که به جای خاصی مربوط می‌شوند.
- خلاصه‌های مرور، که خلاصه‌های قابل‌فهمی از آنچه مرورکنندگان درباره یک مکان گفته‌اند هستند.
- خلاصه‌های منطقه، که نمای کلی از مکان‌های محبوب و نزدیک در منطقه اطراف ارائه می‌دهد. این موارد شامل خلاصه محله و خلاصه ایستگاه شارژ خودرو برقی است.
Google این خلاصه‌ها را به‌طور مکرر بازتولید می‌کند تا مطمئن شود که براساس جدیدترین اطلاعات دردسترس، تازه هستند. وقتی درخواست Places API (جدید) می‌دهید، جدیدترین داده‌ها را در برنامه‌تان نمایش خواهید داد.
انتقال به Places API (جدید)
اگر مشتری فعلی Places API (قدیمی) هستید و می‌خواهید برنامه‌تان را به استفاده از Places API (جدید) انتقال دهید، مستندات انتقال زیر را ببینید:
- انتقال به «جزئیات مکان» (جدید)
- انتقال به «جستجوی اطراف» (جدید)
- انتقال به «جستجوی نوشتاری» (جدید)
- انتقال به «عکس‌های مکان» (جدید)
- انتقال به «تکمیل خودکار» (جدید)