מעבר לשדות החדשים של נתוני המקומות ב-Places SDK ל-Android 4.0
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מפתחים באזור הכלכלי האירופי (EEA)
בגרסה 4.0 של Places SDK ל-Android, חלו שינויים בכמה שדות של נתוני מקומות (Place.Field). השדות הישנים הוצאו משימוש וימשיכו לפעול עד להסרתם, בהתאם לתנאים ולהגבלות של Google Maps Platform. עם זאת,
אפליקציות שכוללות שדות שהוצאו משימוש יחזירו אזהרות לגבי בנייה. בנוסף, נוספו שדות חדשים של נתוני מקומות בגרסה 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
שימוש בשדות נתונים, חיוב ותמחור
למידע נוסף על שימוש בשדות של נתוני מקומות ליצירת מסכות שדות, ועל חיוב ותמחור של כל שדה והמק"ט המתאים לו, אפשר לעיין במקורות המידע הבאים:
[null,null,["עדכון אחרון: 2025-08-30 (שעון UTC)."],[],[],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)"]]
