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

مقدمه

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

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

• تغییرات پاسخ «جستجوی نوشتاری»
• تغییرات پاسخ «جستجوی اطراف»
• تغییرات پاسخ «جزئیات مکان»

تغییرات در شیء «مکان» پاسخ

این جدول تغییرات جدید 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	در «میانای برنامه‌سازی کاربردی» قدیمی، فیلد name حاوی نام مکان به‌صورت رشته نوشتاری بود. در «میانای برنامه‌سازی کاربردی» جدید، این اطلاعات در displayName قرار دارد.
نوع اصلی مکان		primaryTypeName	جدید
نوع اصلی را به‌عنوان رشته نوشتاری قرار دهید		primaryTypeDisplayName	جدید
ساعات کاری ثانویه هفتگی منظم، با استثنائات و همه داده‌های دیگر		regularSecondaryOpeningHours	جدید
گزینه‌های پرداختی که این مکان می‌پذیرد		paymentOptions	جدید
گزینه‌های پارکینگ مکان		parkingOptions	جدید
فهرست زیرمقاصد مربوط به مکان		subDestinations	جدید
جدیدترین اطلاعات درباره گزینه‌های سوخت در پمپ بنزین		fuelOptions	جدید
اطلاعات شارژ خودرو برقی برای یک مکان		evChargeOptions	جدید
مشخصه‌های مکان‌ها		outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports	جدید

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

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

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

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

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

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

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

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

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