نمای کلی Places API (Legacy).

مقدمه

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

جدول زیر نسخه های مربوط به هر دو API را فهرست می کند. از این راهنما برای درک تفاوت های کلیدی بین این دو و مهاجرت به Places API (جدید) استفاده کنید.

Places API (قدیمی)	Places API (جدید)	یادداشت ها
یافتن مکان (میراث)	جستجوی متن (جدید)	نسخه جدیدی از Find Place (Legacy) وجود ندارد. جستجوی متن (جدید) جایگزین آن شده است.
جستجوی نزدیک (قدمتی)	جستجوی نزدیک (جدید)	همه درخواست‌هایی که از API قدیمی استفاده می‌کنند و شامل عبارت جستجوی متنی هستند باید از جستجوی متن (جدید) استفاده کنند زیرا جستجوی نزدیک (جدید) از ورودی متن پشتیبانی نمی‌کند.
جستجوی متن (قدیمی)	جستجوی متن (جدید)
جزئیات مکان (قدمتی)	جزئیات مکان (جدید)
عکس‌های مکان (قدمتی)	عکس‌های مکان (جدید)
تکمیل خودکار مکان (قدمتی)	تکمیل خودکار (جدید)
تکمیل خودکار پرس و جو (قدمتی)	تکمیل خودکار (جدید)	قابلیت های اضافه شده به تکمیل خودکار (جدید).

به API های جدید مهاجرت کنید

برای مهاجرت به APIهای جدید، به راهنمای مهاجرت زیر مراجعه کنید:

• مهاجرت به جستجوی اطراف (جدید)
• مهاجرت به جستجوی متن (جدید)
• مهاجرت به جزئیات مکان (جدید)
• مهاجرت به عکس‌های مکان (جدید)
• انتقال به تکمیل خودکار (جدید)

ویژگی های کلیدی اضافه شده به Places API (جدید)

این بخش ویژگی های کلیدی اضافه شده به Places API (جدید) را پوشش می دهد.

بر روی پلت فرم استاندارد Google Cloud پیاده سازی شده است

Places API (جدید) در زیرساخت خدمات در Google Cloud پیاده سازی شده است. این پیاده سازی یک پلت فرم امن تر و قابل اعتماد با گزینه های امنیتی پیشرفته مانند OAuth را به همراه دارد. این طراحی استاندارد API سطحی از سازگاری را در بین APIها به ارمغان می آورد که کارایی توسعه را با Places API (جدید) بهبود می بخشد.

عملکرد بهبود یافته است

Places API (جدید) عملکرد بهبود یافته ای را ارائه می دهد و جایگزینی برنامه هایی که از Places API موجود استفاده می کنند ارزشمند است.

قیمت گذاری ساده شده

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

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

داده‌های پاسخ منسجم برای یک مکان

با APIهای قدیمی، APIهای جزئیات مکان (میراث)، جستجوی نزدیک (میراث)، و جستجوی متن (میراث) داده های پاسخ متفاوتی را برای یک مکان برمی گرداندند. Places API (جدید) پاسخ را استاندارد می کند، بنابراین همه این APIها داده های یکسانی را برای یک مکان برمی گرداند.

انواع مکان های گسترده

پاسخ API اکنون می تواند حاوی نوع اصلی مکان باشد. هر مکان می تواند یک مقدار نوع واحد داشته باشد که به عنوان نوع اصلی مکان مشخص شده است، همانطور که در جدول A فهرست شده است.

API جدید همچنین شامل چندین نوع جدید است. می توانید از این انواع جدید و انواع موجود در جستجو با جستجوی نزدیک (جدید) و جستجوی متن (جدید) استفاده کنید. انواع جدید همه در جدول A گنجانده شده است.

داده های مکان پویا

Places API (جدید) از داده‌های پاسخ پویا، مانند در دسترس بودن ایستگاه شارژ EV یا آخرین قیمت سوخت برای پمپ بنزین پشتیبانی می‌کند. از این فیلدهای پاسخ برای ایجاد تجربیات کاربر پویا استفاده کنید.