Zoom to extent of all features
It can be convenient and useful for users to zoom to the extent of all features in a FeatureLayer once an app loads, when a layer is added to the map, or when a layer's definitionExpression is updated.
The FeatureLayer API provides a method called queryExtent(), which allows you to calculate the full extent of features at runtime that statisfy a given query. If no query parameters are set, then the method queries for the extent of all features in the layer according to its definitionExpression
.
Note that when working with client-side FeatureLayers, you will need to call queryExtent() on the FeatureLayerView to see the expected behavior.
The FeatureLayer has a fullExtent property that contains an extent object saved to the feature service. Since some FeatureLayers are created from client-side features, other services, or feature services that don't contain an accurate fullExtent
of the data, using the fullExtent
to zoom to all features in the layer can be unreliable in some cases. The queryExtent()
method is more reliable when working with layers that either don't have a fullExtent
, or the fullExtent
doesn't accurately reflect the extent of the data.