DEPRECATION

Legacy Ocean Basemap

Last Published: July 14, 2022

Description

Esri is retiring a legacy Ocean basemap in December 2022. Once the basemap is retired, it will no longer be available to use in maps and apps. 

If you are using this basemap, you must point your applications to the equivalent Ocean Basemap in general availability. 
The Ocean basemap in general availability was created in 2018 and continues to be updated on a regular basis. If you started using the Ocean basemap after this date, you likely are using the equivalent basemap in general availability and don’t need to make any changes. If you’re unsure, keep reading.

A blog post is available on this topic: Notification that a legacy Ocean Basemap will be retired in 2022

Recommendation

ArcGIS Online users: 
If you are the owner of a web map in ArcGIS Online, the easiest way to migrate to the correct version of the Ocean basemap is by selecting Oceans in the Map Viewer Basemap Gallery. To check what basemap is used in your web map, go to the item details page for the web map and look for the basemap in the Layers list. If you are using a deprecated basemap, upgrade to the basemap in general availability.

To change the basemap, open the web map in the Map Viewer, select the new basemap from the Basemap Gallery, and save the web map.
 
ArcGIS Enterprise users:
An administrator must confirm that the basemap in the Basemap Gallery is pointing to the correct version of the Ocean basemap. Once this step is complete, users in your organization can open web maps in the Map Viewer, select the new basemap from the Basemap Gallery, and save the web map.

ArcGIS Pro and ArcMap users: 
Select the basemap in the Basemap Gallery and save the project.
 
Developers using ArcGIS APIs and SDKs:
When referencing a web map, follow the instructions for ArcGIS Online or ArcGIS Enterprise users.

If you are referencing the deprecated or retiring basemap by enumeration, by item, or by REST URL, you must modify code to reference the basemap in general availability. This is the retiring REST endpoint you can check for.

  • Ocean_Basemap - https://services.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer 

If you have a developer subscription, you should refer to basemaps for developers for more details.

Article ID:000027888

Software:
  • ArcMap
  • ArcGIS Server
  • ArcGIS Online
  • ArcGIS Pro

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Related Information

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options