انتقال پاسخ «میانای برنامه‌سازی کاربردی مکان‌ها» (قدیمی)

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

مقدمه

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

علاوه‌براین، فیلدهای سطح بالای شیء پاسخ نیز برای هر API تغییر کرده است. مشاهده:

تغییرات در شیء Place پاسخ

این جدول تغییرات شیء جدید Place را در پاسخ «جزئیات مکان (جدید)»، «جستجوی اطراف (جدید)»، و «جستجوی نوشتار (جدید)» در مقایسه با شیء قدیمی Place نشان می‌دهد.

شیء پاسخ جدید از نگارش شتری برای نام فیلدها استفاده می‌کند، حاوی فیلدهای جدید است، و نام برخی‌از فیلدهای قدیمی را تغییر می‌دهد.

فیلد شیء Places API (قدیمی) شیء Places API (جدید) یادداشت‌ها
عنصر نشانی address_components addressComponents
نشانی ریزقالب مکان adr_address adrFormatAddress
وضعیت کسب‌وکار business_status businessStatus
ساعت کاری هفته آینده current_opening_hours currentOpeningHours
خلاصه نویسندگان editorial_summary editorialSummary
نشانی قالب‌بندی‌شده formatted_address formattedAddress
شماره تلفن ملی formatted_phone_number nationalPhoneNumber
مکان geometry.location location
ناحیه نمایش geometry.viewport viewport
ذکر منبع مکان html_attributions attributions فیلد سطح بالای پاسخ در APIهای قدیمی
نشانی وب نماد icon برداشته شد. از iconMaskBaseUri و iconBackgroundColor استفاده کنید. برای اطلاعات بیشتر، نمادهای مکان را ببینید.
رنگ پس‌زمینه نماد icon_background_color iconBackgroundColor
نشانی وب ماسک نماد icon_mask_base_uri iconMaskBaseUri
شماره تلفن بین‌المللی international_phone_number internationalPhoneNumber
نام مکان نوشتار name displayName نام مکان نوشتاری اکنون به‌صورت displayName.text و language به‌صورت displayName.languageCode دردسترس است
ساعت شروع به‌کار opening_hours regularOpeningHours
Photos photos photos قالب photos در شیء جدید Place تغییر کرده است. برای اطلاعات بیشتر، تغییر در ارجاع‌های عکس را ببینید.
شناسه مکان place_id id
Plus code plus_code plusCode
سطح قیمت‌ها price_level priceLevel
رده‌بندی rating rating
مرورها reviews reviews
ساعت کاری ثانویه برای هفته آینده از امروز، با استثناها و همه داده‌های دیگر secondary_opening_hours currentSecondaryOpeningHours
انواع مکان types types
نشانی وب Google Maps مکان url googleMapsUri
تعداد رده‌بندی‌های کاربر user_ratings_total userRatingCount
اختلاف با ساعت هماهنگ جهانی utc_offset utcOffsetMinutes
شکل کوتاه نشانی شامل نام خیابان و شهر vicinity shortFormattedAddress
وب‌سایت مکان website websiteUri
اطلاعات دسترس‌پذیری با صندلی چرخدار wheelchair_accessible_entrance accessibilityOptions ‫wheelchair_accessible_entrance اکنون در accessibilityOptions.wheelchairAccessibleEntrance است
مشخصه‌های مکان‌ها takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
نام منبع فیلد name در فرم places/PLACE_ID در API قدیمی، فیلد name حاوی نام مکان به‌صورت رشته نوشتاری بود. در میانای برنامه‌سازی کاربردی جدید، این اطلاعات در displayName قرار دارد.
نوع اصلی مکان primaryTypeName جدید
نوع اصلی را به‌صورت رشته نوشتاری قرار دهید primaryTypeDisplayName جدید
ساعات کاری ثانویه هفتگی منظم، با استثناها و همه داده‌های دیگر regularSecondaryOpeningHours جدید
گزینه‌های پرداختی که این مکان می‌پذیرد paymentOptions جدید
گزینه‌های پارکینگ مکان parkingOptions جدید
فهرست مقصدهای فرعی مرتبط با آن جا subDestinations جدید
جدیدترین اطلاعات درباره گزینه‌های سوخت در پمپ بنزین fuelOptions جدید
اطلاعات شارژ خودرو برقی برای یک مکان evChargeOptions جدید
مشخصه‌های مکان‌ها outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports جدید

تغییرات پاسخ «جستجوی نوشتار»

جدول زیر تغییرات فیلدهای سطح بالا را برای شیء پاسخ در «جستجوی نوشتار (قدیمی)» و شیء پاسخ در «جستجوی نوشتار (جدید)» نشان می‌دهد. برای API جدید، تنها فیلد سطح بالا در پاسخ، آرایه places است.

فیلد جستجوی نوشتار (قدیمی) جستجوی نوشتار (جدید) یادداشت‌ها
ذکر منبع مکان html_attributions به شیء جدید مکان برای هر مکان به‌عنوان place.attributions منتقل شد
آرایه مکان‌ها آرایه results از شیء قدیمی Place آرایه places از شیء Place جدید
وضعیت درخواست status به پاسخ‌های HTTP استاندارد (کد و پیام پاسخ‌های HTTP) منتقل شد
هرگونه پیام خطا error_message به پاسخ‌های HTTP استاندارد (کد و پیام پاسخ‌های HTTP) منتقل شد
هرگونه پیام اطلاعاتی info_messages برداشته‌شده
کد صفحه next_page_token برداشته‌شده

تغییرات پاسخ «جستجوی اطراف»

جدول زیر تغییرات فیلدهای سطح بالا را برای شیء پاسخ در «جستجوی اطراف (قدیمی)» و شیء پاسخ در «جستجوی اطراف (جدید)» نشان می‌دهد. برای API جدید، تنها فیلد سطح بالا در پاسخ، آرایه places است.

فیلد جستجوی اطراف (قدیمی) جستجوی اطراف (جدید) یادداشت‌ها
ذکر منبع مکان html_attributions به شیء جدید مکان برای هر مکان به‌عنوان place.attributions منتقل شد
آرایه مکان‌ها آرایه results از شیء قدیمی Place places آرایه شیء جدید Place
وضعیت درخواست status به پاسخ‌های HTTP استاندارد (کد و پیام پاسخ‌های HTTP) منتقل شد
هرگونه پیام خطا error_message به پاسخ‌های HTTP استاندارد (کد و پیام پاسخ‌های HTTP) منتقل شد
هرگونه پیام اطلاعاتی info_messages برداشته‌شده
کد صفحه next_page_token برداشته‌شده

تغییرات پاسخ «جزئیات جا (جدید)»

جدول زیر تغییرات ایجادشده در فیلدهای سطح بالای شیء پاسخ برای «جزئیات مکان (قدیمی)» و شیء پاسخ برای «جزئیات مکان (جدید)» را نشان می‌دهد. برای API جدید، تنها فیلد سطح بالا در پاسخ، آرایه places است.

فیلد جزئیات جا (قدیمی) جزئیات جا (جدید) یادداشت‌ها
ذکر منبع مکان html_attributions به شیء جدید مکان به‌عنوان attributions منتقل شد
جزئیات جا (جدید) result حاوی شیء قدیمی Place شیء Place جدید
وضعیت درخواست status به پاسخ‌های HTTP استاندارد (کد و پیام پاسخ‌های HTTP) منتقل شد
هرگونه پیام اطلاعاتی info_messages به پاسخ‌های HTTP استاندارد (کد و پیام پاسخ‌های HTTP) منتقل شد