Add StreetMap Premium data

StreetMap Premium for ArcGIS Runtime provides enriched street data, which powers a high-quality cartographic mapsA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more and high-quality search, geocodingGeocoding is the process of converting text for an address or place to a complete address with a location.Learn more, and routeA route is a polyline that defines the best path between two or more points in a street network.Learn more analysis. StreetMap Premium maps are consistent across all regions of the world and can be taken offline for disconnected use; they can simultaneously fulfill the need for an address locatorA locator is an ArcGIS dataset that stores address information and the rules for translating descriptions of places (such as street addresses or place names) into spatial data that can be displayed on a map.Learn more, street network dataset, and basemapA basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service.Learn more in your app.

StreetMap Premium delivers data as a mobile map packageA mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more (an .mmpk file) for your app to access locally. This format allows the data to be accessed offline (without a network connection, in other words) and therefore doesn't consume data from your user's data plan. This is the same high-quality data used by ArcGIS Online services, including the Geocoding service, Routing service, and Basemap styles service. Instead of spending your time putting together such datasets yourself, you can focus on developing apps that provide advanced searching, geocodingGeocoding is the process of converting text for an address or place to a complete address with a location.Learn more, and routing analysis offline.

StreetMap Premium data is organized into regions that are licensed as extensions and are downloaded individually (North America, Latin America, Europe, the Middle East, Africa, and Asia Pacific), allowing your apps to provide a consistent user experience across the globe. Within these regions, maps are available at the sub-region, country, or state/province level. You can even use ArcGIS Pro to clip the data to a custom area of interest.

How to add StreetMap Premium data

Follow these general steps to use StreetMap Premium in your app.

1. Download the sample version of the StreetMap Premium Greater Los Angeles mobile map package that is provided for development and testing. When you're ready to deploy your app, you'll need to download the required StreetMap Premium packages from My Esri and license StreetMap Premium for each extension (region) your app uses.

2. Provide the data (mobile map package) for your app. You can provide package(s) with your app or allow the user to download them as needed. Once the package (*.mmpk) is available on the client, you can open it to retrieve data, maps, and locatorsA locator is an ArcGIS dataset that stores address information and the rules for translating descriptions of places (such as street addresses or place names) into spatial data that can be displayed on a map.Learn more. Using the contents of the package, you can:

   • Display StreetMap Premium data in your app.
   • Locate addresses and places using a StreetMap Premium locator task.
   • Solve routes using the transportation network dataset provided in the StreetMap Premium map package.

License StreetMap Premium

Each StreetMap Premium region is licensed as an extension. A StreetMap Premium extension license works with all license levels: Lite, Basic, Standard, and Advanced. Unlike other extension licenses, this license does not unlock API capabilities, but rather licenses the use of StreetMap Premium data within one of the available regions. For each region you license, you receive a license string to use in your app. These licenses are good for one year, so you must provide a mechanism to notify your users and update the license string for your app when (or before) the license expires.

You could also read license strings on startup from a text file included with the app and set the licenses. This would allow the user to update license strings in a separate file and would eliminate the need for you to update and recompile the app code.

As the licenses in your app near expiration, you might want to notify the user that new licensing information will be required soon.

Display StreetMap Premium data

Inside each StreetMap Premium mobile map packageA mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more, you'll find two mapsA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more: Navigation Day and StreetMap Day. Each of these maps display the same data and use similar symbology for the layers. They also use scale dependent rendering to improve display performance and readability. The Navigation Day map, however, displays streets with a wider symbol and with more and larger labels, as illustrated in the following image. You can choose the map that best suits the use case, device, screen size, and so on for your app.

Locate addresses and places

In addition to street data and maps, each StreetMap Premium mobile map packageA mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more contains a locatorA locator is an ArcGIS dataset that stores address information and the rules for translating descriptions of places (such as street addresses or place names) into spatial data that can be displayed on a map.Learn more task. Use the locator task to geocodeGeocoding is the process of converting text for an address or place to a complete address with a location.Learn more addresses, intersections, or places of interest within the area covered by the package.

Solve routes

Maps in a StreetMap Premium package have an associated transportation network dataset. You can use this dataset to solve routesA route is a polyline that defines the best path between two or more points in a street network.Learn more between two or more locations in the street network. The mapsA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more must be loaded before you can access the transportation dataset it contains.