Migrar para os novos campos de dados de local no SDK do Places para Android 4.0
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Desenvolvedores do Espaço Econômico Europeu (EEE)
Na versão 4.0 do
SDK do Places para Android, vários campos de dados de lugar
(Place.Field)
foram alterados. Os campos antigos foram descontinuados e vão continuar funcionando até serem removidos, de acordo com os Termos de Serviço da Plataforma Google Maps. No entanto, os apps que incluem campos descontinuados vão retornar avisos de build. Além disso, novos campos de dados de lugar foram adicionados na versão 4.0. As seções a seguir fornecem detalhes sobre mudanças e novos campos, além de uso, faturamento e preços.
Mudanças e descontinuações de campos na versão 4.0
A tabela a seguir lista os campos descontinuados e as substituições deles:
Campo descontinuado
Novo campo
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
Novos campos introduzidos na versão 4.0
Os seguintes campos de dados de lugar foram adicionados na versão 4.0 do SDK do Places para 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
Uso, faturamento e preços dos campos de dados
Para mais informações sobre como usar campos de dados de lugar para criar máscaras de campo, bem como sobre faturamento e preços de cada campo e da SKU correspondente, consulte os seguintes recursos:
[null,null,["Última atualização 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)"]]
