نسخه API خود را انتخاب کنید

Places API از دو نسخه API پشتیبانی می کند: Places API APIهای موجود هستند و Places API (جدید) نسخه نسل بعدی APIها هستند.

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

لیست API ها

جدول زیر هر دو مجموعه API را فهرست می کند. اگر مشتری فعلی هستید، از این جدول برای تعیین API جدید استفاده کنید که جایگزین API است که در حال حاضر استفاده می کنید.

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

اگر از یک 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 آمده است.

تایپ کنید
رستوران_آمریکایی تخفیف_فروشگاه بستنی فروشی ساندویچ_فروشی
مرکز_تفریح سگ_پارک رستوران هندی محدوده مدرسه
رشته_ ورزشی ایستگاه_شارژ_خودرو_برقی اندونزی_رستوران رستوران غذاهای دریایی
فروشگاه_قطعات_خودرو رویداد_محل برگزاری رستوران ایتالیایی پیست اسکی
سالن های ضیافت طولانی_ اقامت_هتل رستوران ژاپنی رستوران_اسپانیایی
باربیکیو_رستوران مزرعه رستوران_کوری فروشگاه_کالاهای_ورزشی
آرایشگاه مزرعه رستوران_لبنانی باشگاه ورزشی
تخت_و_صبحانه رستوران فست فود مارینا مجموعه ورزشی
رستوران_برزیلی ترمینال_فری بازار استیک_خانه
صبحانه_رستوران مرکز تناسب اندام آزمایشگاه_پزشکی سوشی_رستوران
برانچ_رستوران رستوران فرانسوی رستوران_مدیترانه ای استخر
ایستگاه اتوبوس هدیه_فروشگاه رستوران مکزیکی خیاط
کمپینگ_کابین زمین_گلف رستوران_خاورمیانه ارائه دهنده خدمات_ مخابراتی
فروشگاه_موبایل یونانی_رستوران متل تای_رستوران
آژانس_مراقبت_کودک فروشگاه بقالی پارک ملی transit_depot
رستوران چینی مهمان خانه پارک_و_سواری کامیون_ایست
کافی شاپ سالن آرایش تئاتر_هنرهای_نمایش رستوران_تورکی
مرکز ارتباطات همبرگر_رستوران پیتزا_رستوران رستوران_وگان
مشاور هلی فرودگاه زمین بازی رستوران_گیاهی
مرکز کنوانسیون منطقه پیاده روی پیش دبستانی رستوران_ویتنامی
کلبه نشانه_ تاریخی اتاق_مهمان_خصوصی بازدید کننده_مرکز
پیک_خدمات خانه_بهبود_فروشگاه رامن_رستوران محل برگزاری عروسی
مرکز فرهنگی خوابگاه resort_hotel عمده فروش
کلینیک دندانپزشکی هتل استراحت_توقف
همراه با این انواع جدید، Places SDK برای Android (جدید) انواع زیر را از جدول B از جدول A منتقل کرد. یعنی اکنون می توانید از این انواع به عنوان بخشی از جستجو استفاده کنید:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

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

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

کدام API را انتخاب می کنید؟

قبل از اینکه بتوانید توسعه برنامه را شروع کنید، باید API خود را انتخاب کنید:

  1. اگر مشتری جدیدی هستید که به تازگی با Places API شروع کرده اید، با API های جدید شروع کنید.

  2. اگر مشتری جدیدی هستید و هنوز جایگزینی برای یک API موجود، مانند Place Autocomplete یا Query Autocomplete وجود ندارد ، می توانید از ترکیبی از API های جدید و موجود استفاده کنید.

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

    برای اطلاعات بیشتر در مورد مهاجرت، به نمای کلی مهاجرت مراجعه کنید.