مقدمه
قالب پاسخ برای APIهای Place Details (جدید) ، Nearby Search (جدید) و Text Search (جدید) نسبت به قالب APIهای قدیمی تغییر کرده است. تفاوت اصلی در قالب شیء Place است که توسط هر متد برگردانده می‌شود، همانطور که در بخش تغییرات شیء Place در پاسخ توضیح داده شده است.
علاوه بر این، فیلدهای سطح بالای شیء پاسخ نیز برای هر API تغییر کرده‌اند. ببینید:
تغییرات در شیء Place پاسخ
این جدول تغییرات شیء جدید Place را در پاسخ برای Place Details (جدید)، Nearby Search (جدید) و Text Search (جدید) در مقایسه با شیء قدیمی Place نشان می‌دهد.
شیء پاسخ جدید از روش camel-casing برای نام فیلدها استفاده می‌کند، فیلدهای جدیدی را در خود جای می‌دهد و نام برخی از فیلدهای قدیمی را تغییر می‌دهد.
| میدان | شیء Places API (Legacy) | شیء 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 در شیء جدید 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 است. |
| ویژگی‌های مکان‌ها | 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 | جدید | |
| اطلاعات شارژ خودروهای برقی برای یک مکان | evChargeOptions | جدید | |
| ویژگی‌های مکان‌ها | outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports | جدید |
تغییرات پاسخ جستجوی متن
جدول زیر تغییرات در فیلدهای سطح بالای شیء پاسخ برای جستجوی متن (Legacy) و شیء پاسخ برای جستجوی متن (New) را نشان می‌دهد. برای API جدید، تنها فیلد سطح بالای پاسخ، آرایه places است.
| میدان | جستجوی متن (قدیمی) | جستجوی متن (جدید) | یادداشت‌ها |
|---|---|---|---|
| انتساب مکان | html_attributions | برای هر مکان به عنوان place.attributions به شیء جدید Place منتقل شد | |
| آرایه‌ای از مکان‌ها | آرایه results شیء قدیمی Place | آرایه places از شیء جدید Place | |
| وضعیت درخواست | status | به پاسخ استاندارد HTTP (کد و پیام پاسخ HTTP) منتقل شد. | |
| هرگونه پیام خطایی | error_message | به پاسخ استاندارد HTTP (کد و پیام پاسخ HTTP) منتقل شد. | |
| هرگونه پیام اطلاعاتی | info_messages | حذف شد | |
| توکن صفحه | next_page_token | حذف شد |
تغییرات پاسخ جستجوی نزدیک
جدول زیر تغییرات در فیلدهای سطح بالای شیء پاسخ برای جستجوی نزدیک (Legacy) و شیء پاسخ برای جستجوی نزدیک (New) را نشان می‌دهد. برای API جدید، تنها فیلد سطح بالای پاسخ، آرایه places است.
| میدان | جستجوی نزدیک (قدیمی) | جستجوی نزدیک (جدید) | یادداشت‌ها |
|---|---|---|---|
| انتساب مکان | html_attributions | برای هر مکان به عنوان place.attributions به شیء جدید Place منتقل شد | |
| آرایه‌ای از مکان‌ها | آرایه results شیء قدیمی Place | آرایه places از شیء جدید Place | |
| وضعیت درخواست | status | به پاسخ استاندارد HTTP (کد و پیام پاسخ HTTP) منتقل شد. | |
| هرگونه پیام خطایی | error_message | به پاسخ استاندارد HTTP (کد و پیام پاسخ HTTP) منتقل شد. | |
| هرگونه پیام اطلاعاتی | info_messages | حذف شد | |
| توکن صفحه | next_page_token | حذف شد |
تغییرات پاسخ جزئیات مکان (جدید)
جدول زیر تغییرات در فیلدهای سطح بالای شیء پاسخ برای Place Details (Legacy) و شیء پاسخ برای Place Details (New) را نشان می‌دهد. برای API جدید، تنها فیلد سطح بالای پاسخ، آرایه places است.
| میدان | جزئیات مکان (میراث) | جزئیات مکان (جدید) | یادداشت‌ها |
|---|---|---|---|
| انتساب مکان | html_attributions | به عنوان attributions به شیء Place جدید منتقل شد | |
| جزئیات مکان (جدید) | result که شامل شیء قدیمی Place است | شیء جدید Place | |
| وضعیت درخواست | status | به پاسخ استاندارد HTTP (کد و پیام پاسخ HTTP) منتقل شد. | |
| هرگونه پیام اطلاعاتی | info_messages | به پاسخ استاندارد HTTP (کد و پیام پاسخ HTTP) منتقل شد. |