به فیلدهای داده مکان جدید در Places SDK برای Android نسخه 4.0 مهاجرت کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA).
در نسخه 4.0 Places SDK برای Android، چندین فیلد داده مکان ( Place.Field ) تغییر کرد. فیلدهای قدیمی منسوخ شده‌اند و مطابق با شرایط خدمات پلتفرم Google Maps تا زمانی که حذف نشوند به کار خود ادامه خواهند داد. با این حال، برنامه‌هایی که شامل فیلدهای منسوخ شده هستند، هشدارهای ساخت را برمی‌گردانند. علاوه بر این، فیلدهای جدید داده مکان در نسخه 4.0 اضافه شد. بخش‌های زیر جزئیاتی در مورد تغییرات فیلدها و فیلدهای جدید و همچنین استفاده از میدان، صورت‌حساب و قیمت‌گذاری ارائه می‌کنند.
تغییرات فیلد و حذف در نسخه 4.0
جدول زیر فیلدهای منسوخ شده و جایگزین های آنها را فهرست می کند:
فیلد منسوخ شده
زمینه جدید
Place.Field.ADDRESS
Place.Field.FORMATTED_ADDRESS
Place.Field.ICON_URL
Place.Field.ICON_MASK_URL
Place.Field.LAT_LNG
Place.Field.LOCATION
Place.Field.NAME
Place.Field.DISPLAY_NAME
Place.Field.PHONE_NUMBER
Place.Field.INTERNATIONAL_PHONE_NUMBER
Place.Field.USER_RATINGS_TOTAL
Place.Field.USER_RATING_COUNT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Place.Field.ACCESSIBILITY_OPTIONS
فیلدهای جدید معرفی شده در نسخه 4.0
فیلدهای داده مکان زیر در نسخه 4.0 Places SDK برای Android اضافه شده است:
Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.ADR_FORMAT_ADDRESS
Place.Field.ALLOWS_DOGS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.GOOGLE_MAPS_URI
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.RESOURCE_NAME
Place.Field.RESTROOM
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.SUB_DESTINATIONS
استفاده از فیلد داده، صورت‌حساب و قیمت‌گذاری
برای اطلاعات بیشتر در مورد استفاده از فیلدهای داده مکان برای ایجاد ماسک‌های فیلد، و همچنین در مورد صورت‌حساب و قیمت‌گذاری هر فیلد و SKU مربوط به آن، به منابع زیر مراجعه کنید:
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Migrate to the new Place Data Fields in the Places SDK for Android 4.0\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nIn [version 4.0](/maps/documentation/places/android-sdk/release-notes) of\nPlaces SDK for Android, several of the Place data fields\n([`Place.Field`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.Field))\nchanged. The old fields have been deprecated and will continue to work until\nthey are removed, in accordance with the [Google Maps Platform Terms of\nService](https://cloud.google.com/maps-platform/terms). However,\napps that include deprecated fields will return build warnings. In addition, new\nPlace data fields were added in version 4.0. The following sections provide\ndetails on field changes and new fields, as well as field usage, billing, and\npricing.\n| **Note:** The changes and additions to the Place data fields apply to both the Places SDK and the Places SDK (New).\n\nField changes and deprecations in version 4.0\n---------------------------------------------\n\nThe following table lists the deprecated fields and their replacements:\n\n| Deprecated field | New field |\n|----------------------------------------------|------------------------------------------|\n| `Place.Field.ADDRESS` | `Place.Field.FORMATTED_ADDRESS` |\n| `Place.Field.ICON_URL` | `Place.Field.ICON_MASK_URL` |\n| `Place.Field.LAT_LNG` | `Place.Field.LOCATION` |\n| `Place.Field.NAME` | `Place.Field.DISPLAY_NAME` |\n| `Place.Field.PHONE_NUMBER` | `Place.Field.INTERNATIONAL_PHONE_NUMBER` |\n| `Place.Field.USER_RATINGS_TOTAL` | `Place.Field.USER_RATING_COUNT` |\n| `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` | `Place.Field.ACCESSIBILITY_OPTIONS` |\n\n| **Note:** `Place.Field.ACCESSIBILITY_OPTIONS` is only available in the Places SDK (New). If you are using the Places SDK, continue using `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE`.\n\nNew fields introduced in version 4.0\n------------------------------------\n\nThe following Place data fields have been added in version 4.0 of the\nPlaces SDK for Android:\n\n- `Place.Field.ACCESSIBILITY_OPTIONS`\n- `Place.Field.ADR_FORMAT_ADDRESS`\n- `Place.Field.ALLOWS_DOGS`\n- `Place.Field.CURRENT_SECONDARY_OPENING_HOURS`\n- `Place.Field.EV_CHARGE_OPTIONS`\n- `Place.Field.FUEL_OPTIONS`\n- `Place.Field.GOOD_FOR_CHILDREN`\n- `Place.Field.GOOD_FOR_GROUPS`\n- `Place.Field.GOOD_FOR_WATCHING_SPORTS`\n- `Place.Field.GOOGLE_MAPS_URI`\n- `Place.Field.LIVE_MUSIC`\n- `Place.Field.MENU_FOR_CHILDREN`\n- `Place.Field.NATIONAL_PHONE_NUMBER`\n- `Place.Field.OUTDOOR_SEATING`\n- `Place.Field.PARKING_OPTIONS`\n- `Place.Field.PAYMENT_OPTIONS`\n- `Place.Field.PRIMARY_TYPE_DISPLAY_NAME`\n- `Place.Field.RESOURCE_NAME`\n- `Place.Field.RESTROOM`\n- `Place.Field.SERVES_COCKTAILS`\n- `Place.Field.SERVES_COFFEE`\n- `Place.Field.SERVES_DESSERT`\n- `Place.Field.SHORT_FORMATTED_ADDRESS`\n- `Place.Field.SUB_DESTINATIONS`\n\n| **Note:** The `RESOURCE_NAME` field contains the place resource name in the form: `places/PLACE_ID`. Use `DISPLAY_NAME` to access the text name of the place.\n\nData field usage, billing, and pricing\n--------------------------------------\n\nFor more information about using Place data fields to create field masks, as\nwell as about billing and pricing for each field and its corresponding SKU, see\nthe following resources:\n\n- [Place Data Fields (New)](/maps/documentation/places/android-sdk/data-fields)\n- [Place Data Fields](/maps/documentation/places/android-sdk/place-data-fields)\n- [Place SDK for Android Usage and Billing](/maps/documentation/places/android-sdk/usage-and-billing)"]]
