Set feature request mode

View on GitHubSample viewer app

Use different feature request modes to populate the map from a service feature table.

Screenshot of set feature request mode

Use case

Feature tables can be initialized with a feature request mode which controls how frequently features are requested and locally cached in response to panning, zooming, selecting, or querying. The feature request mode affects performance and should be chosen based on considerations such as how often the data is expected to change or how often changes in the data should be reflected to the user.

  • OnInteractionCache - fetches features within the current extent when needed (after a pan or zoom action) from the server and caches those features in a table on the client. Queries will be performed locally if the features are present, otherwise they will be requested from the server. This mode minimizes requests to the server and is useful for large batches of features which will change infrequently.

  • OnInteractionNoCache - always fetches features from the server and doesn't cache any features on the client. This mode is best for features that may change often on the server or whose changes need to always be visible.

    NOTE: No cache does not guarantee that features won't be cached locally. Feature request mode is a performance concept unrelated to data security.

  • ManualCache - only fetches features when explicitly populated from a query. This mode is best for features that change minimally or when it is not critical for the user to see the latest changes.

How to use the sample

Choose a request mode by clicking on the drop down menu. Pan and zoom to see how the features update at different scales. If you choose "Manual cache", click the "Populate" button to manually get a cache with a subset of features.

Note: The service limits requests to 2000 features.

How it works

  1. Create a ServiceFeatureTable with a feature service URL and use it to create a FeatureLayer.
  2. Add the feature layer to the map's operational layers.
  3. Set the FeatureRequestMode property of the service feature table to the desired mode (OnInteractionCache, OnInteractionNoCache, or ManualCache).
    • If using ManualCache, populate the features with ServiceFeatureTable.populateFromService(...).

Relevant API

  • FeatureLayer
  • ServiceFeatureTable
  • ServiceFeatureTable.FeatureRequestMode

About the data

This sample uses the Trees of Portland service showcasing over 200,000 street trees in Portland, OR. Each tree point models the health of the tree (green - better, red - worse) as well as the diameter of its trunk.

Tags

cache, data, feature, feature request mode, performance

Sample Code

SetFeatureRequestModeViewModel.ktSetFeatureRequestModeViewModel.ktMainActivity.ktSetFeatureRequestModeScreen.kt
Use dark colors for code blocksCopy
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
/* 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
 *
 *    http://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.
 *
 */

package com.esri.arcgismaps.sample.setfeaturerequestmode.components

import android.app.Application
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.setValue
import androidx.lifecycle.AndroidViewModel
import androidx.lifecycle.viewModelScope
import com.arcgismaps.data.FeatureRequestMode
import com.arcgismaps.data.QueryParameters
import com.arcgismaps.data.ServiceFeatureTable
import com.arcgismaps.geometry.Envelope
import com.arcgismaps.mapping.ArcGISMap
import com.arcgismaps.mapping.BasemapStyle
import com.arcgismaps.mapping.Viewpoint
import com.arcgismaps.mapping.layers.FeatureLayer
import com.esri.arcgismaps.sample.sampleslib.components.MessageDialogViewModel
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
import java.util.Collections

class SetFeatureRequestModeViewModel(application: Application) : AndroidViewModel(application) {

    // Feature table of street trees in Portland
    private val featureTable =
        ServiceFeatureTable("https://services2.arcgis.com/ZQgQTuoyBrtmoGdP/arcgis/rest/services/Trees_of_Portland/FeatureServer/0")

    val arcGISMap =
        ArcGISMap(BasemapStyle.ArcGISTopographic).apply {
            // Set a viewpoint to downtown Portland, OR
            initialViewpoint = Viewpoint(latitude = 45.5266, longitude = -122.6219, scale = 6000.0)
            // Create a feature layer from the feature table and add it to the map
            operationalLayers.add(FeatureLayer.createWithFeatureTable(featureTable))
        }

    private var viewpoint: Viewpoint? = null
        private set

    var currentFeatureRequestMode by mutableStateOf<FeatureRequestMode>(FeatureRequestMode.OnInteractionCache)
        private set

    var isLoading by mutableStateOf(false)
        private set

    // Create a message dialog view model for handling error messages
    val messageDialogVM = MessageDialogViewModel()

    init {
        viewModelScope.launch {
            arcGISMap.load().onFailure { error ->
                messageDialogVM.showMessageDialog(
                    "Failed to load map",
                    error.message.toString()
                )
            }
        }
    }

    /**
     * Called when the viewpoint of the map changes.
     */
    fun onViewpointChange(viewpoint: Viewpoint) {
        this.viewpoint = viewpoint
    }

    /**
     * Called when the feature request mode is changed.
     */
    fun onCurrentFeatureRequestModeChanged(featureRequestMode: FeatureRequestMode) {
        currentFeatureRequestMode = featureRequestMode
        featureTable.featureRequestMode = featureRequestMode
    }

    /**
     * Demonstrates how to manually fetch features from the service feature table using the current viewpoint.
     */
    fun fetchCacheManually() {

        // Show the progress indicator
        isLoading = true

        // Create query to select all tree features
        val queryParams = QueryParameters().apply {
            // Query for all tree conditions except "dead" with coded value '4' within the visible extent
            whereClause = "Condition < '4'"
            geometry = viewpoint?.targetGeometry as Envelope
        }

        // Setting this to * means all features
        val outfields: List<String> = Collections.singletonList("*")

        viewModelScope.launch(Dispatchers.IO) {
            // Get queried features from service feature table and clear previous cache
            featureTable.populateFromService(
                parameters = queryParams,
                clearCache = true,
                outFields = outfields
            ).onSuccess {
                // hide the loading ProgressBar
                isLoading = false
            }
        }
    }
}

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