Query with time extent

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
// Copyright 2025 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 QueryWithTimeExtentView: View {
    /// A map with an ocean basemap style.
    @State private var map: Map = {
        let map = Map(basemapStyle: .arcGISOceans)

        // Sets the initial viewpoint of the map.
        map.initialViewpoint = Viewpoint(latitude: 20.0, longitude: -55.0, scale: 9e7)

        return map
    }()

    /// The error shown in the error alert.
    @State private var error: (any Error)?

    var body: some View {
        MapView(map: map)
            .task {
                do {
                    let featureTable = ServiceFeatureTable(url: .hurricanesService)

                    // Sets the feature request mode to manual (only manual is currently
                    // supported). In this mode, you must manually populate the table -
                    // panning and zooming won't request features automatically.
                    featureTable.featureRequestMode = .manualCache

                    let layer = FeatureLayer(featureTable: featureTable)

                    map.addOperationalLayer(layer)

                    try await populateFeatures(from: featureTable)
                } catch {
                    self.error = error
                }
            }
    }

    /// Populates the service feature table using queried features.
    /// - Parameter featureTable: The service feature table.
    private func populateFeatures(from featureTable: ServiceFeatureTable) async throws {
        // Creates parameters to query for features within the time extent.
        let queryParameters = QueryParameters()
        let timeExtent = TimeExtent(startDate: .startDate, endDate: .endDate)
        queryParameters.timeExtent = timeExtent

        _ = try await featureTable.populateFromService(
            using: queryParameters,
            clearCache: false,
            outFields: ["*"]
        )
    }
}

private extension Date {
    static let startDate = Calendar.current.date(from: DateComponents(year: 2000, month: 9, day: 1))!
    static let endDate = Calendar.current.date(from: DateComponents(year: 2000, month: 9, day: 22))!
}

private extension URL {
    static var hurricanesService: URL {
        URL(string: "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Hurricanes/MapServer/0")!
    }
}

#Preview {
    QueryWithTimeExtentView()
}