Add StreetMap Premium data

StreetMap Premium for ArcGIS Runtime provides enriched street data, which powers a high-quality cartographic and high-quality search, , and 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 , street network dataset, and in your app.

StreetMap Premium delivers data from HERE Technologies as a (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, , 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.

How to add StreetMap Premium data

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

  1. Download 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 . Using the contents of the package, you can:

  3. 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 string 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 string 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 strings when they expire, you will need to update and recompile the app code.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
// ArcGIS Runtime license string
let myRuntimeLicenseKey = "runtimelite,1000,rudxxxxxxxxx,28-feb-2019,xxxxxxxxxxxxxxxxxxxx"

// Extension license strings for various StreetMap Premium areas
let smpNorthAmerica = "runtimesmpna,1000,rudxxxxxxxxx,13-mar-2023,xxxxxxxxxxxxxxxxxxxx"
let smpLatinAmerica = "runtimesmpla,1000,rudxxxxxxxxx,13-mar-2023,xxxxxxxxxxxxxxxxxxxx"
let smpEurope = "runtimesmpe,1000,rudxxxxxxxxx,16-dec-2023,xxxxxxxxxxxxxxxxxxxx"

// Set the license for ArcGIS Runtime and the three extensions (areas)
do {
 try AGSArcGISRuntimeEnvironment.setLicenseKey(myRuntimeLicenseKey, extensions: [smpEurope, smpLatinAmerica, smpNorthAmerica])
 print("Licensed SMP extensions")
}
catch {
 print(error)
}

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.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
// ... code here to read license strings from a text file into an array of strings ...
// Variable to store the (one) ArcGIS Runtime license string
var runtimeLicense = ""
// Variable to store the extension license string (all others in the file)
var extensionLicenses = [""]
// Loop through all license strings from the file
for licenseString in licenseStrings {
 if licenseString.starts(with: "runtimelite") ||
  licenseString.starts(with: "runtimebasic") ||
  licenseString.starts(with: "runtimestandard") ||
  licenseString.starts(with: "runtimeadvanced") {
  runtimeLicense = licenseString
 }
 else {
  extensionLicenses.append(licenseString)
 }
}
// Set the licenses before using any ArcGIS Runtime objects
do {
 try AGSArcGISRuntimeEnvironment.setLicenseKey(runtimeLicense, extensions: extensionLicenses)
 print("Licensed SMP extensions")
}
catch {
 print(error)
}

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

The following code loops through all extension licenses for the app and notifies the user if a license is within 10 days of expiring.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
//get the licensing info for the current app
let licenseInfo = AGSArcGISRuntimeEnvironment.license()
//get all extension licenses
let extensionLicenses = licenseInfo.extensions
//loop through extension licenses and see when each expires
for extensionLicense in extensionLicenses {
 let extensionName = extensionLicense.name
 //get the expiry date
 let expiryDate = extensionLicense.expiry
 let today = Date()
 if let expiryDate = expiryDate {
  //get the number of days until the license expires
  let days = Calendar.current.dateComponents([.day], from: expiryDate, to: Date()).day
  if let days = days {
   //if within 10 days of expiration, notify the user
   if days <= 10 {
    print("Warning: License will expire in \(days) days")
   }
  }
}

Display StreetMap Premium data

Inside each StreetMap Premium , you'll find two : 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.

Street map (left) and Navigation map (right)

The following example opens a StreetMap Premium mobile map package file and displays the Navigation Day map in the app's map view.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
// Open a StreetMap Premium mobile map package
let indianaPackage = AGSMobileMapPackage(name: "IndianaMobileMapPackage")

// Get the first map
let map = indianaPackage.maps.first

// Add it to the map view
self.mapView.map = map

Locate addresses and places

In addition to street data and maps, each StreetMap Premium contains a task. Use the locator task to addresses, intersections, or places of interest within the area covered by the package.

The following example opens a StreetMap Premium mobile map package file, gets the associated AGSLocatorTask , and uses it to find a location.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
// Get the locator task for this area
let locatorTask = indianaPackage.locatorTask

// Get geocode candidates
locatorTask?.geocode(withSearchText: "Indianapolis Motor Speedway", completion: { (results, error) in
 if let error = error {
  print(error)
  return
 }
 // Get the candidate with the best score
 guard let results = results else {return}
 //process the results
})

Solve routes

Maps in a StreetMap Premium package have an associated transportation network dataset. You can use this dataset to solve between two or more locations in the street network. The must be loaded before you can access the transportation dataset it contains.

The following example gets a AGSTransportationNetworkDataset from a map in the StreetMap Premium package, then uses it to create a new AGSRouteTask .

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
// Get the (first and only) street network dataset from one of the maps in the package
let network = self.map.transportationNetworks.first
guard let streetNetwork = network else {return}
// Create a new route task that uses the street network
let routeTask = AGSRouteTask(dataset: streetNetwork)
// Get the default route parameters from the task and solve the route
/...

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close