قالب پاسخ برای APIهای جدید Place Details ، Nearby Search و Text Search نسبت به قالب APIهای قدیمی تغییر کرده است. تفاوت اصلی در قالب شیء Place است که توسط هر متد برگردانده می شود، همانطور که در Changes to the response Object Place توضیح داده شده است.
علاوه بر این، فیلدهای سطح بالای شی پاسخ نیز برای هر API تغییر کرده است. ببینید:
تغییرات در پاسخ شی Place
این جدول تغییرات شی Place جدید را در پاسخ برای جزئیات مکان (جدید)، جستجوی نزدیک (جدید) و جستجوی متن (جدید) در مقایسه با شی Place قدیمی نشان می‌دهد.
شی پاسخ جدید از پوشش شتر برای نام فیلدها استفاده می کند، حاوی فیلدهای جدید است و برخی از فیلدهای قدیمی را تغییر نام می دهد.
| میدان | شئ Legacy 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 از شیء قدیمی Place | آرایه places های شی جدید Place | |
| وضعیت درخواست | status | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) | |
| هرگونه پیام خطایی | error_message | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) | |
| هرگونه پیام اطلاعاتی | info_messages | حذف شد | |
| توکن صفحه | next_page_token | حذف شد |
پاسخ جستجوی اطراف تغییر می کند
جدول زیر تغییرات فیلدهای سطح بالای شیء پاسخ برای جستجوی نزدیک (میراث) و شیء پاسخ برای جستجوی نزدیک (جدید) را نشان می دهد. برای API جدید، تنها فیلد سطح بالا در پاسخ، آرایه places است.
| میدان | جستجوی نزدیک (قدمتی) | جستجوی نزدیک (جدید) | یادداشت ها |
|---|---|---|---|
| اسناد مکان | html_attributions | به شی Place جدید برای هر مکان به عنوان 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 است | شی مکان جدید | |
| وضعیت درخواست | status | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) | |
| هرگونه پیام اطلاعاتی | info_messages | به پاسخ استاندارد HTTP منتقل شد (کد و پیام پاسخ HTTP) |