پاسخ Places API را انتقال دهید

قالب پاسخ برای 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)