قالب پاسخ برای APIهای جدید مکان ، جستجوی نزدیک ، و جستجوی متن از قالب APIهای موجود تغییر کرده است. تفاوت اصلی در قالب شیء Place است که توسط هر متد برگردانده می شود، همانطور که در Changes to the response Object Place توضیح داده شده است.
علاوه بر این، فیلدهای سطح بالای شی پاسخ نیز برای هر API تغییر کرده است. ببینید:
تغییرات در پاسخ شی Place
این جدول تغییرات شی Place جدید را در پاسخ برای جزئیات مکان (جدید)، جستجوی نزدیک (جدید) و جستجوی متن (جدید) در مقایسه با شی Place موجود نشان می‌دهد.
شی پاسخ جدید از پوشش شتر برای نام فیلدها استفاده می کند، حاوی فیلدهای جدید است و نام برخی از فیلدهای موجود را تغییر می دهد.
| میدان | شی مکان موجود | شی مکان جدید | یادداشت ها |
|---|---|---|---|
| جزء آدرس | 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 در شی جدید Place تغییر کرده است. برای اطلاعات بیشتر، تغییر به مراجع عکس را ببینید. |
| شناسه مکان | place_id | id | |
| کد پلاس | plus_code | plusCode | |
| سطح قیمت | price_level | priceLevel | |
| رتبه بندی | rating | rating | |
| بررسی ها | reviews | reviews | |
| ساعات کار ثانویه برای هفته آینده از امروز، با استثنا و همه داده‌های دیگر | secondary_opening_hours | currentSecondaryOpeningHours | |
| انواع مکان | types | types | |
| آدرس گوگل مپ مکان | url | googleMapsUri | |
| تعداد امتیازات کاربران | user_ratings_total | userRatingCount | |
| افست UTC | utc_offset | utcOffsetMinutes | |
| فرم کوتاه آدرس شامل نام خیابان و شهر | vicinity | shortFormattedAddress | |
| وب سایت مکان | website | websiteUri | |
| اطلاعات دسترسی به ویلچر | wheelchair_accessible_entrance | accessibilityOptions | wheelchair_accessible_entrance اکنون در accessibilityOptions.wheelchairAccessibleEntrance است.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 حاوی نام مکان به عنوان یک رشته متنی است. در API جدید، این اطلاعات در displayName هستند. | |
| محل نوع اولیه | primaryTypeName | جدید | |
| نوع اصلی را به عنوان یک رشته متن قرار دهید | primaryTypeDisplayName | جدید | |
| ساعات کار ثانویه هفتگی منظم، با استثنا و همه داده‌های دیگر | regularSecondaryOpeningHours | جدید | |
| گزینه های پرداخت محل می پذیرد | paymentOptions | جدید | |
| گزینه های پارکینگ محل | parkingOptions | جدید | |
| فهرست مقاصد فرعی مربوط به مکان | subDestinations | جدید | |
| جدیدترین اطلاعات در مورد گزینه های سوخت در پمپ بنزین | fuelOptions | جدید | |
| اطلاعات شارژ EV برای یک مکان | evChargeOptions | جدید | |
| صفات مکان ها | outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports | جدید |
پاسخ جستجوی متن تغییر می کند
جدول زیر تغییرات فیلدهای سطح بالای شی پاسخ برای جستجوی متن موجود و شی پاسخ برای جستجوی متن (جدید) را نشان می دهد. برای API جدید، تنها فیلد سطح بالا در پاسخ، آرایه places است.
| میدان | جستجوی متن (موجود) | جستجوی متن (جدید) | یادداشت ها |
|---|---|---|---|
| اسناد مکان | html_attributions | به شی Place جدید برای هر مکان به عنوان place.attributions منتقل شد | |
| مجموعه ای از مکان ها | آرایه results شی مکان موجود | آرایه places های شی جدید Place | |
| وضعیت درخواست | status | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) | |
| هرگونه پیام خطایی | error_message | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) | |
| هرگونه پیام اطلاعاتی | info_messages | حذف شد | |
| توکن صفحه | next_page_token | حذف شد |
پاسخ جستجوی اطراف تغییر می کند
جدول زیر تغییرات فیلدهای سطح بالای شیء پاسخ را برای جستجوی نزدیک موجود و شیء پاسخ برای جستجوی نزدیک (جدید) نشان می دهد. برای API جدید، تنها فیلد سطح بالا در پاسخ، آرایه places است.
| میدان | جستجوی نزدیک (موجود) | جستجوی نزدیک (جدید) | یادداشت ها |
|---|---|---|---|
| اسناد مکان | html_attributions | به شی Place جدید برای هر مکان به عنوان place.attributions منتقل شد | |
| مجموعه ای از مکان ها | آرایه results شی مکان موجود | آرایه places های شی جدید Place | |
| وضعیت درخواست | status | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) | |
| هرگونه پیام خطایی | error_message | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) | |
| هرگونه پیام اطلاعاتی | info_messages | حذف شد | |
| توکن صفحه | next_page_token | حذف شد |
پاسخ جزئیات مکان تغییر می کند
جدول زیر تغییرات فیلدهای سطح بالای شی پاسخ را برای جزئیات مکان موجود و شی پاسخ برای جزئیات مکان (جدید) نشان می دهد. برای API جدید، تنها فیلد سطح بالا در پاسخ، آرایه places است.
| میدان | جزئیات مکان (موجود) | جزئیات مکان (جدید) | یادداشت ها |
|---|---|---|---|
| اسناد مکان | html_attributions | به عنوان attributions به شی مکان جدید منتقل شد | |
| جزئیات مکان | result حاوی شی مکان موجود است | شی مکان جدید | |
| وضعیت درخواست | status | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) | |
| هرگونه پیام اطلاعاتی | info_messages | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) |