مقدمه
API مکان‌ها (جدید) شامل APIهای زیر است:
این سند شامل مروری بر این APIهای جدید است.
جزئیات مکان (جدید)
یک شناسه مکان، یک مکان را به طور منحصر به فرد در پایگاه داده Google Places و در Google Maps مشخص می‌کند. با یک شناسه مکان، می‌توانید با شروع یک درخواست جزئیات مکان (جدید) ، جزئیاتی در مورد یک موسسه یا نقطه مورد علاقه خاص درخواست کنید. درخواست جزئیات مکان (جدید) اطلاعات جامعی در مورد مکان مشخص شده مانند آدرس کامل، شماره تلفن، امتیاز کاربران و نظرات را برمی‌گرداند.
راه‌های زیادی برای دریافت شناسه مکانی وجود دارد. می‌توانید از موارد زیر استفاده کنید:
- جستجوی متن (جدید)
- جستجوی نزدیک (جدید)
- API کدگذاری جغرافیایی
- API مسیرها
- API اعتبارسنجی آدرس
- تکمیل خودکار (جدید)
عکس‌های مکان (جدید)
Place Photos (جدید) با دسترسی به میلیون‌ها عکس ذخیره شده در پایگاه داده Google Places، به شما امکان می‌دهد محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. با استفاده از API Place Photos (جدید)، می‌توانید به عکس‌ها دسترسی پیدا کرده و اندازه تصویر را به اندازه بهینه برای برنامه خود تغییر دهید.
تمام درخواست‌ها به API مربوط به Place Photos (جدید) باید شامل یک نام منبع عکس باشند که به طور منحصر به فرد، عکسی را که قرار است برگردانده شود، مشخص می‌کند. می‌توانید نام منبع عکس را با استفاده از دستور زیر به دست آورید:
برای درج نام منبع عکس در پاسخ از درخواست‌های Place Details (جدید)، Text Search (جدید) یا Nearby Search (جدید)، مطمئن شوید که فیلد photos را در Field Mask درخواست قرار داده‌اید.
جستجوی متن (جدید) و جستجوی نزدیک (جدید)
API مکان‌ها شامل دو API جستجو است:
به شما امکان می‌دهد یک رشته متنی را برای جستجوی یک مکان مشخص کنید. برای مثال: "غذاهای گیاهی تند در سیدنی، استرالیا" یا "رستوران غذاهای دریایی مرغوب در نزدیکی پالو آلتو، کالیفرنیا".
شما می‌توانید جستجو را با مشخص کردن جزئیاتی مانند سطح قیمت، وضعیت فعلی باز بودن، رتبه‌بندی‌ها یا انواع مکان‌های خاص، اصلاح کنید. همچنین می‌توانید مشخص کنید که نتایج به یک مکان خاص متمایل شوند یا جستجو را به یک مکان خاص محدود کنید.
به شما امکان می‌دهد منطقه‌ای را برای جستجو به همراه لیستی از انواع مکان‌ها مشخص کنید. منطقه را به صورت دایره‌ای تعریف کنید که با مختصات عرض و طول جغرافیایی نقطه مرکزی و شعاع بر حسب متر تعریف شده است.
یک یا چند نوع مکان را که ویژگی‌های مکان را تعریف می‌کنند، مشخص کنید. برای مثال، برای جستجوی یک رستوران پیتزا واقع در یک مرکز خرید در منطقه مشخص شده، "
pizza_restaurant" و "shopping_mall" را مشخص کنید.
تفاوت اصلی بین این دو جستجو این است که جستجوی متن (جدید) به شما امکان می‌دهد یک رشته جستجوی دلخواه را مشخص کنید در حالی که جستجوی نزدیک (جدید) به یک منطقه خاص برای جستجو نیاز دارد.
تکمیل خودکار (جدید) و توکن‌های جلسه
تکمیل خودکار (جدید) یک سرویس وب است که پیش‌بینی‌های مکان و پیش‌بینی‌های پرس‌وجو را در پاسخ به یک درخواست HTTP برمی‌گرداند. در درخواست، یک رشته جستجوی متنی و مرزهای جغرافیایی که منطقه جستجو را کنترل می‌کنند، مشخص کنید.
توکن‌های جلسه، رشته‌های تولید شده توسط کاربر هستند که فراخوانی‌های تکمیل خودکار (جدید) را به عنوان جلسات ردیابی می‌کنند. تکمیل خودکار (جدید) از توکن‌های جلسه برای گروه‌بندی مراحل پرس‌وجو و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صورتحساب استفاده می‌کند.
فیلدها، ویژگی‌ها و گزینه‌های دسترسی جدید
API مکان‌ها (جدید) شامل فیلدها، ویژگی‌ها و گزینه‌های دسترسی جدیدی است تا اطلاعات بیشتری در مورد یک مکان در اختیار کاربران قرار دهد. این جنبه‌ها در بخش‌های بعدی توضیح داده شده‌اند.
فیلدها
API مکان‌ها (جدید) شامل چندین فیلد جدید است:
| میدان | توضیحات |
|---|---|
regularSecondaryOpeningHours | زمان‌های خاص برای عملیات خاص را توصیف می‌کند. ساعات کاری ثانویه با ساعات کاری اصلی یک کسب‌وکار متفاوت است. برای مثال، یک رستوران می‌تواند ساعات کاری درایو-تر یا ساعات تحویل را به عنوان ساعات کاری ثانویه خود مشخص کند. |
paymentOptions | گزینه‌های پرداختی که مکان می‌پذیرد. یک مکان می‌تواند بیش از یک گزینه پرداخت را بپذیرد. اگر داده‌های گزینه پرداخت در دسترس نباشد، فیلد گزینه پرداخت غیرفعال خواهد شد. گزینه‌ها شامل موارد زیر هستند:
|
parkingOptions | گزینه‌های پارکینگ ارائه شده توسط محل. گزینه‌ها شامل موارد زیر است:
|
subDestinations | مکان‌های منحصر به فردی که به یک مکان خاص مرتبط هستند. برای مثال، ترمینال‌های فرودگاه، زیرمجموعه‌های یک فرودگاه محسوب می‌شوند. |
fuelOptions | جدیدترین اطلاعات در مورد گزینه‌های سوخت موجود در پمپ بنزین. این اطلاعات مرتباً به‌روزرسانی می‌شود. گزینه‌ها شامل موارد زیر است:
|
evChargeOptions | تعداد شارژرهای خودروهای برقی (EV) در این ایستگاه. در حالی که برخی از شارژرهای خودروهای برقی دارای چندین کانکتور هستند، هر شارژر فقط می‌تواند یک خودرو را در یک زمان شارژ کند؛ در نتیجه، این فیلد تعداد شارژرهای موجود برای خودروهای برقی در یک زمان معین را نشان می‌دهد. |
shortFormattedAddress | یک آدرس کوتاه و قابل خواندن توسط انسان برای یک مکان. |
primaryType | نوع اصلی نتیجه داده شده. برای مثال، یک مکان ممکن است به عنوان cafe یا airport طبقه‌بندی شود. یک مکان فقط می‌تواند یک نوع اصلی داشته باشد. برای لیست کامل مقادیر ممکن، به انواع پشتیبانی شده مراجعه کنید. |
primaryTypeDisplayName | نام نمایشی نوع اصلی، که در صورت لزوم به زبان درخواست بومی‌سازی شده است. برای لیست کامل مقادیر ممکن، به انواع پشتیبانی شده مراجعه کنید. |
ویژگی‌ها
API مکان‌ها (جدید) شامل چندین ویژگی جدید است:
| ویژگی | توضیحات |
|---|---|
outdoorSeating | مکان، فضای نشیمن در فضای باز را فراهم می‌کند. |
liveMusic | این مکان موسیقی زنده ارائه می‌دهد. |
menuForChildren | این مکان منوی مخصوص کودکان دارد. |
servesCocktails | این مکان کوکتل سرو می‌کند. |
servesDessert | این مکان دسر سرو می‌کند. |
servesCoffee | این مکان قهوه سرو می‌کند. |
goodForChildren | مکان برای کودکان خوب است. |
allowsDogs | مکان به سگ‌ها اجازه ورود می‌دهد. |
restroom | مکان دارای سرویس بهداشتی است. |
goodForGroups | این مکان پذیرای گروه‌ها است. |
goodForWatchingSports | مکان مناسبی برای تماشای مسابقات ورزشی است. |
گزینه‌های دسترسی
API مکان‌ها (جدید) شامل فیلدهای گزینه‌های دسترسی زیر است:
| میدان | توضیحات |
|---|---|
wheelchairAccessibleParking | این مکان پارکینگ با دسترسی مناسب برای ویلچر ارائه می‌دهد. |
wheelchairAccessibleEntrance | این مکان ورودی مخصوص معلولین با صندلی چرخدار دارد. |
wheelchairAccessibleRestroom | این مکان دارای سرویس بهداشتی مناسب برای ویلچر است. |
wheelchairAccessibleSeating | این مکان دارای صندلی‌های مناسب برای ویلچر است. |
خلاصه‌های مبتنی بر هوش مصنوعی
API مکان‌ها (جدید) خلاصه‌های مبتنی بر هوش مصنوعی از قابلیت‌های مدل Gemini برای ارائه خلاصه‌هایی درباره مکان‌ها و مناطقی استفاده می‌کنند که می‌توانند به کاربران در تصمیم‌گیری برای رفتن به مکان‌های دیگر کمک کنند.
خلاصه‌های مبتنی بر هوش مصنوعی، داده‌ها را از ورودی‌های مختلف ترکیب می‌کنند تا به کاربران در تصمیم‌گیری آگاهانه‌تر در مورد یک مکان کمک کنند. به عنوان مثال، اگر در حال بررسی یک رستوران جدید هستید، یک خلاصه مبتنی بر هوش مصنوعی می‌تواند نکات برجسته منو را نشان دهد، ایده‌ای از حال و هوای آن رستوران به شما بدهد یا مضامین نظرات کاربران را جمع‌آوری کند. اگر در حال بازدید از یک شهر جدید هستید، یک خلاصه مبتنی بر هوش مصنوعی می‌تواند نمای کلی از جاذبه‌ها و امکانات رفاهی اطراف را ارائه دهد.
ویژگی‌های مبتنی بر هوش مصنوعی به Places API اضافه شدند (جدید)
خلاصه‌های مبتنی بر هوش مصنوعی توسط جزئیات مکان (جدید) ، جستجوی متن (جدید) و جستجوی نزدیک (جدید) پشتیبانی می‌شوند. خلاصه‌های مبتنی بر هوش مصنوعی زیر در پاسخ‌های API مکان‌ها (جدید) در دسترس هستند:
- خلاصه مکان‌ها ، که خلاصه‌های اجمالی کوتاهی مربوط به یک مکان خاص هستند.
- خلاصه نظرات ، که خلاصه‌های قابل فهمی از نظرات منتقدان در مورد یک مکان هستند.
- خلاصه‌های منطقه ، که نمای کلی از مکان‌های نزدیک و محبوب در منطقه اطراف را ارائه می‌دهد. این شامل خلاصه‌های محله و خلاصه‌های ایستگاه‌های شارژ خودروهای برقی می‌شود.
گوگل مرتباً این خلاصه‌ها را بازسازی می‌کند تا از به‌روز بودن آنها بر اساس آخرین اطلاعات موجود اطمینان حاصل کند. وقتی درخواست Places API (جدید) را ارسال می‌کنید، جدیدترین داده‌ها را در برنامه خود نمایش خواهید داد.
مهاجرت به APIهای مکان‌های جدید
اگر شما از مشتریان فعلی Places API (جدید) هستید و می‌خواهید برنامه خود را برای استفاده از APIهای جدید منتقل کنید، به مستندات مهاجرت زیر مراجعه کنید:
- انتقال به جزئیات مکان (جدید)
- مهاجرت به جستجوی نزدیک (جدید)
- مهاجرت به جستجوی متنی (جدید)
- انتقال به مکان عکس‌ها (جدید)
- مهاجرت به تکمیل خودکار (جدید)