StreetMap Premium for ArcGIS Runtime provides enriched street data, which powers a high-quality cartographic map and high-quality search, geocoding, and route 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 locator, street network dataset, and basemap in your app.
StreetMap Premium delivers data from HERE Technologies as a mobile map package (an .mmpk file) for your app to access locally. This MMPK 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 World Geocoding Service, Routing Service, and Street Map Service. Instead of spending your time putting together such datasets yourself, you can focus on developing apps that provide advanced searching, geocoding, and routing analysis offline.
StreetMap Premium data is organized into regions that are licensed as extensions to ArcGIS Runtime 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.
StreetMap Premium for ArcGIS Runtime is updated regularly, for example: North America three times per year, Europe two times per year, and Latin America, Asia Pacific, Middle East and Africa once per year.
Follow these general steps to use StreetMap Premium in your ArcGIS Runtime app.
- Download StreetMap Premium mobile map package(s) required by your app. When you're ready to deploy your app, you'll need to license StreetMap Premium for each extension (region) your app uses.
You do not need a license for developing and testing with StreetMap Premium data. StreetMap Premium for ArcGIS Runtime is included with your ArcGIS Developer subscription. When you deploy an app using StreetMap Premium data, you will need to license your app as described in the License StreetMap Premium section of this topic. Therefore, while developing and testing, do not call the code used to license your app.
- 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 locators. Using the contents of the package, you can:
- Attribute StreetMap Premium data somewhere in the app user interface using the words mapping data from HERE. If you're attributing more than one data provider, the HERE attribution cannot be less prominent than the attribution for the other data providers. See Attribution in your app for more information.
License StreetMap Premium
Each StreetMap Premium region is licensed as an extension to ArcGIS Runtime. A StreetMap Premium extension license works with all license levels of ArcGIS Runtime (Lite, Basic, Standard, and Advanced). Unlike other ArcGIS Runtime 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 key as a "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 key for your app when (or before) the license expires.
The following code licenses ArcGIS Runtime and several StreetMap Premium extensions when the app initializes. To update these license keys when they expire, you will need to update and recompile the app code.
QStringList extensions = QStringList();
You could also read license keys on startup from a text file included with the app and set the licenses. This would allow the user to update license keys 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.
License* license = ArcGISRuntimeEnvironment::license();
QList<ExtensionLicense> extensionLicenses = license->extensions();
for (ExtensionLicense license : extensionLicenses)
QString name = license.name();
qint64 expiry = license.expiry().toMSecsSinceEpoch();
qint64 now = QDateTime::currentMSecsSinceEpoch();
qDebug() << "expiry:" << expiry << ", now:" << now;
long daysLeft = (expiry - now) / 1000 / 60 / 60 / 24;
if (daysLeft <= 1000)
qDebug() << "Days left until " << name << " expires: " << daysLeft;
For details on licensing your ArcGIS Runtime app, see License your app.
Display StreetMap Premium data
Inside each StreetMap Premium mobile map package, you'll find two maps: 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.
m_mmpk = new MobileMapPackage(m_pathToPackage, this);
if (m_mmpk && m_mmpk->loadStatus() == LoadStatus::NotLoaded)
connect(m_mmpk, &MobileMapPackage::doneLoading, this,
m_map = m_mmpk->maps().at(0); // Access first map in mmpk
While StreetMap Premium data may support some capabilities outside of geocoding, routing, and map display (such as query, spatial analysis, and filtering of individual data layers) it is neither intended nor designed for such uses.
Locate addresses and places
In addition to street data and maps, each StreetMap Premium mobile map package contains a locator task. Use the locator task to geocode addresses, intersections, or places of interest within the area covered by the package.
m_locatorTask = m_mmpk->locatorTask();
connect(m_locatorTask, &LocatorTask::geocodeCompleted, this,
[this, &geocodeResults] (QUuid, const QList<GeocodeResult>& geocodeResults)
GeocodeResult result = geocodeResults.at(0);
m_locatorTask->geocode("Indianapolis Motor Speedway");
For more information on geocoding, see Search for places (geocoding).
Maps in a StreetMap Premium package have an associated transportation network dataset. You can use this dataset to solve routes between two or more locations in the street network. The map must be loaded before you can access the transportation dataset it contains.
The following example gets a TransportationNetworkDataset from a map in the StreetMap Premium package, then uses it to create a new RouteTask.
TransportationNetworkDataset* streetNetwork = m_mapView->map()->transportationNetworks().at(0);
m_routeTask = new RouteTask(streetNetwork);
connect(m_routeTask, &RouteTask::doneLoading, this,
connect(m_routeTask, &RouteTask::createDefaultParametersCompleted, this,
[this](QUuid, const RouteParameters& defaultParameters)
void UseStreetMapPremium::startSolveRouteTask(const RouteParameters& defaultParameters)
RouteParameters params = defaultParameters;
connect(m_routeTask, &RouteTask::solveRouteCompleted, this,
[this](QUuid, const RouteResult routeResult)
connect(m_routeTask, &RouteTask::errorOccurred, this,
[this](const Error error)
qDebug() << "RouteTask solveRoute returned an error: " << error.message() << ": " << error.additionalMessage();
void UseStreetMapPremium::processRouteResult(RouteResult routeResult)
Route route = routeResult.routes().at(0);
See Find a route for more information about working with a route task.