-
Notifications
You must be signed in to change notification settings - Fork 9
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'v.next' into chriswebb/New-ShowDeviceLocationUsingIndoo…
…rPositioning
- Loading branch information
Showing
40 changed files
with
579 additions
and
346 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
50 changes: 50 additions & 0 deletions
50
Shared/Samples/Add web tiled layer/AddWebTiledLayerView.swift
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,50 @@ | ||
// Copyright 2024 Esri | ||
// | ||
// Licensed under the Apache License, Version 2.0 (the "License"); | ||
// you may not use this file except in compliance with the License. | ||
// You may obtain a copy of the License at | ||
// | ||
// https://www.apache.org/licenses/LICENSE-2.0 | ||
// | ||
// Unless required by applicable law or agreed to in writing, software | ||
// distributed under the License is distributed on an "AS IS" BASIS, | ||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
// See the License for the specific language governing permissions and | ||
// limitations under the License. | ||
|
||
import ArcGIS | ||
import SwiftUI | ||
|
||
struct AddWebTiledLayerView: View { | ||
/// A map with web tiled layer. | ||
@State private var map: Map = { | ||
// Build the web tiled layer from ArcGIS Living Atlas of the World tile service url. | ||
let webTiledLayer = WebTiledLayer(urlTemplate: .worldTileServiceStringURL) | ||
webTiledLayer.setAttribution(.attributionString) | ||
|
||
let basemap = Basemap(baseLayer: webTiledLayer) | ||
let map = Map(basemap: basemap) | ||
map.initialViewpoint = Viewpoint( | ||
center: Point(x: -1e6, y: 1e6), | ||
scale: 15e7 | ||
) | ||
return map | ||
}() | ||
|
||
var body: some View { | ||
MapView(map: map) | ||
} | ||
} | ||
|
||
private extension String { | ||
/// The attribution string for the ArcGIS Living Atlas of the World. | ||
static let attributionString = """ | ||
Map tiles by <a href="https://livingatlas.arcgis.com">ArcGIS Living Atlas of the World</a>, under <a href="https://www.esri.com/en-us/legal/terms/full-master-agreement">Esri Master License Agreement</a>. Data by Esri, Garmin, GEBCO, NOAA NGDC, and other contributors. | ||
""" | ||
/// The web tile service url from ArcGIS Living Atlas of the World. | ||
static let worldTileServiceStringURL = "https://services.arcgisonline.com/ArcGIS/rest/services/Ocean/World_Ocean_Base/MapServer/tile/{level}/{row}/{col}.jpg" | ||
} | ||
|
||
#Preview { | ||
AddWebTiledLayerView() | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,45 @@ | ||
# Add web tiled layer | ||
|
||
Display a tiled web layer. | ||
|
||
![Image of Add web tiled layer sample](add-web-tiled-layer.png) | ||
|
||
## Use case | ||
|
||
Tiled map services are a set of pre-generated images (e.g., "tiles") arranged in folders for each row, column, and zoom level. As you navigate the map, map tiles are requested for the current extent. `ArcGISTiledLayer` and `WMTSLayer` are types of tiled map services used for specific data types. `WebTiledLayer` is useful for displaying other data sources that contain tiles arranged in a row/column/level directory structure, such as OpenStreetMap. | ||
|
||
## How to use the sample | ||
|
||
Run the sample and a map will appear. As you navigate the map, map tiles will be fetched automatically and displayed on the map. | ||
|
||
## How it works | ||
|
||
Web tiled services use a uniform addressing scheme with pre-rendered tiles. Image tiles are accessed via a URL template string, with parameters for subdomain, level, column, and row. | ||
|
||
* Subdomain is optional and allows the Maps SDK to balance requests among multiple servers for enhanced performance. | ||
* Level, row, and column select the tiles to load based on the visible extent of the map. | ||
|
||
To display the web tiled layer, this sample: | ||
|
||
1. Creates a `WebTiledLayer` from a URL. | ||
2. Creates a new `Basemap` from the layer. | ||
3. Updates the attribution on the layer. Note: this is a necessary step because web tiled services don't have associated service metadata. | ||
4. Displays the basemap. | ||
|
||
For more information about web tiled layers, see the following resources: | ||
|
||
* [Wikipedia: tiled web maps](https://en.wikipedia.org/wiki/Tiled_web_map) | ||
* [ArcGIS Pro: Share a web tile layer](https://pro.arcgis.com/en/pro-app/latest/help/sharing/overview/web-tile-layer.htm) | ||
|
||
## Relevant API | ||
|
||
* Basemap | ||
* WebTiledLayer | ||
|
||
## About the data | ||
|
||
The basemap in this sample is provided by [ArcGIS Living Atlas of the World](https://www.arcgis.com/home/item.html?id=1e126e7520f9466c9ca28b8f28b5e500). ArcGIS Living Atlas of the World provides tiled services with several unique styles. | ||
|
||
## Tags | ||
|
||
layer, OGC, tiled, tiles |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,25 @@ | ||
{ | ||
"category": "Layers", | ||
"description": "Display a tiled web layer.", | ||
"ignore": false, | ||
"images": [ | ||
"add-web-tiled-layer.png" | ||
], | ||
"keywords": [ | ||
"OGC", | ||
"layer", | ||
"tiled", | ||
"tiles", | ||
"Basemap", | ||
"WebTiledLayer" | ||
], | ||
"redirect_from": [], | ||
"relevant_apis": [ | ||
"Basemap", | ||
"WebTiledLayer" | ||
], | ||
"snippets": [ | ||
"AddWebTiledLayerView.swift" | ||
], | ||
"title": "Add web tiled layer" | ||
} |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.