Migrate to new place category IDs

Effective February 20, 2025, Esri will be making changes to our global places data. As a result, the Places service will have new category IDs. If you currently work with this data with ArcGIS Location Platform, you will see changes in the category system, available attributes, and the total number of point of interest (POI) records that can be accessed.

If your application dynamically fetches category IDs at startup via the /categories endpoint, or allows users to search for categories as part of the workflow, you do not need to make any changes.

The steps below outline how to migrate an application that uses the old place category IDs to the new ones:

1. Download the .csv file containing the category mapping below.

   Category mapping file (.csv)

2. Open the downloaded file using a spreadsheet application or any text editor that supports CSV files.

3. The file contains the following columns:

   • category_id_legacy: The old category ID currently used in the Places service.
   • category_id_new: The new category ID you need to transition to.
   • category_label: The descriptive label of the category.

4. Update your application.

   • Locate all instances in the application where the category_id_legacy value is hard-coded or referenced.
   • Replace the old IDs with the corresponding category_id_new values from the file.

5. Test the application to ensure that the new IDs are functioning as expected and that the updated categories are correctly displayed.

6. Complete the migration process before March 22, 2025 to avoid disruptions to your workflow. The service will stop supporting the old category IDs after March 22, 2025.