Di chuyển sang Trường dữ liệu địa điểm mới trong SDK địa điểm dành cho Android 4.0
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)
Trong phiên bản 4.0 của Places SDK for Android, một số trường dữ liệu Địa điểm (Place.Field) đã thay đổi. Các trường cũ đã ngừng hoạt động và sẽ tiếp tục hoạt động cho đến khi bị xoá, theo Điều khoản dịch vụ của Nền tảng Google Maps. Tuy nhiên, các ứng dụng có chứa những trường không dùng nữa sẽ trả về cảnh báo bản dựng. Ngoài ra, các trường dữ liệu mới về Địa điểm đã được thêm vào phiên bản 4.0. Các phần sau đây cung cấp thông tin chi tiết về các thay đổi đối với trường và trường mới, cũng như việc sử dụng trường, việc thanh toán và giá.
Các thay đổi và việc ngừng sử dụng trường trong phiên bản 4.0
Bảng sau đây liệt kê các trường không dùng nữa và trường thay thế:
Trường không dùng nữa
Trường mới
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
Các trường mới được giới thiệu trong phiên bản 4.0
Các trường dữ liệu Địa điểm sau đây đã được thêm vào phiên bản 4.0 của Places SDK cho 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
Mức sử dụng, phí và giá của trường dữ liệu
Để biết thêm thông tin về cách sử dụng các trường dữ liệu Địa điểm để tạo mặt nạ trường, cũng như về việc thanh toán và định giá cho từng trường và SKU tương ứng, hãy xem các tài nguyên sau:
[null,null,["Cập nhật lần gần đây nhất: 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)"]]