مقدمه
API مکان‌ها به شما امکان می‌دهد اطلاعات مربوط به انواع مختلف مکان‌ها را با استفاده از یک رشته متنی یا بر اساس نزدیکی جستجو و بازیابی کنید. API مکان‌ها (قدیمی) نسخه قدیمی API مکان‌ها (جدید) است.
جدول زیر نسخه‌های مربوط به هر دو API را فهرست می‌کند. از این راهنما برای درک تفاوت‌های کلیدی بین این دو و مهاجرت به Places API (جدید) استفاده کنید.
| API مکان‌ها (قدیمی) | API مکان‌ها (جدید) | یادداشت‌ها |
|---|---|---|
| یافتن مکان (میراث) | جستجوی متن (جدید) | نسخه جدیدی از Find Place (Legacy) وجود ندارد. Text Search (جدید) جایگزین آن شده است. |
| جستجوی نزدیک (قدیمی) | جستجوی نزدیک (جدید) | تمام درخواست‌هایی که از API قدیمی استفاده می‌کنند و شامل یک پرس‌وجوی متنی هستند، باید از جستجوی متنی (جدید) استفاده کنند، زیرا جستجوی نزدیک (جدید) از ورودی متن پشتیبانی نمی‌کند. |
| جستجوی متن (قدیمی) | جستجوی متن (جدید) | |
| جزئیات مکان (میراث) | جزئیات مکان (جدید) | |
| عکس‌های مکان (قدیمی) | عکس‌های مکان (جدید) | |
| تکمیل خودکار مکان (قدیمی) | تکمیل خودکار (جدید) | |
| تکمیل خودکار پرس‌وجو (قدیمی) | تکمیل خودکار (جدید) | قابلیت‌های اضافه شده به تکمیل خودکار (جدید). |
مهاجرت به API های جدید
برای مهاجرت به API های جدید، به راهنماهای مهاجرت زیر مراجعه کنید:
- مهاجرت به جستجوی نزدیک (جدید)
- مهاجرت به جستجوی متنی (جدید)
- انتقال به جزئیات مکان (جدید)
- انتقال به مکان عکس‌ها (جدید)
- مهاجرت به تکمیل خودکار (جدید)
ویژگی‌های کلیدی اضافه شده به Places API (جدید)
این بخش ویژگی‌های کلیدی اضافه شده به Places API (جدید) را پوشش می‌دهد.
پیاده‌سازی شده بر روی پلتفرم استاندارد گوگل کلود
API مکان‌ها (جدید) بر روی زیرساخت سرویس در Google Cloud پیاده‌سازی شده است. این پیاده‌سازی، پلتفرمی امن‌تر و قابل اعتمادتر با گزینه‌های امنیتی پیشرفته مانند OAuth را به همراه دارد. این طراحی استاندارد API، سطحی از سازگاری را در بین APIها ایجاد می‌کند که کارایی توسعه با API مکان‌ها (جدید) را بهبود می‌بخشد.
عملکرد بهبود یافته
API مکان‌ها (جدید) عملکرد بهبود یافته‌ای را ارائه می‌دهد، و جایگزینی برنامه‌هایی که از API مکان‌های موجود استفاده می‌کنند را ارزشمند می‌کند.
قیمت‌گذاری ساده‌شده
قیمت‌گذاری با Places API (جدید) ساده شده است، به طوری که شما فقط برای داده‌هایی که استفاده می‌کنید هزینه پرداخت می‌کنید. قیمت‌گذاری ساده‌شده با استفاده از یک field mask پیاده‌سازی شده است.
با استفاده از جزئیات مکان (جدید)، جستجوی نزدیک (جدید) و جستجوی متن (جدید)، شما از ماسک فیلد برای کنترل لیست فیلدهایی که باید در پاسخ برگردانده شوند استفاده می‌کنید. سپس فقط برای داده‌های درخواستی هزینه دریافت می‌کنید. استفاده از ماسک فیلد یک روش طراحی خوب برای اطمینان از عدم درخواست داده‌های غیرضروری است که به جلوگیری از زمان پردازش غیرضروری و هزینه‌های صورتحساب کمک می‌کند.
داده‌های پاسخ سازگار برای یک مکان
با APIهای قدیمی، APIهای جزئیات مکان (قدیمی)، جستجوی نزدیک (قدیمی) و جستجوی متن (قدیمی) داده‌های پاسخ متفاوتی را برای یک مکان برمی‌گرداندند. API مکان‌ها (جدید) پاسخ را استاندارد می‌کند، بنابراین همه این APIها داده‌های یکسانی را برای یک مکان برمی‌گردانند.
انواع مکان‌های گسترش‌یافته
اکنون پاسخ API می‌تواند شامل نوع اصلی یک مکان باشد. هر مکان می‌تواند یک مقدار نوع واحد داشته باشد که به عنوان نوع اصلی مکان مشخص می‌شود، همانطور که در جدول A ذکر شده است.
API جدید همچنین شامل چندین نوع داده جدید است. می‌توانید از این نوع‌های جدید و انواع موجود در جستجو با جستجوی نزدیک (جدید) و جستجوی متن (جدید) استفاده کنید. انواع داده جدید همگی در جدول A گنجانده شده‌اند.
داده‌های مکانی پویا
API مکان‌ها (جدید) از داده‌های پاسخ پویا، مانند در دسترس بودن ایستگاه شارژ خودروهای برقی یا آخرین قیمت سوخت برای یک پمپ بنزین، پشتیبانی می‌کند. از این فیلدهای پاسخ برای ایجاد تجربیات کاربری پویا استفاده کنید.