GeoJSON
- Last UpdatedMar 04, 2025
- 2 minute read
Reads a GeoJSON file from a URL and loads features in the map. This format allows to encode different geographic data structures including Features geometry and properties. The standard supports defining different types of geometries, like Points, Lines and Polygons.
The GeoJSON file does not include drawing information, meaning it does not specify how the geographic data is to be rendered. Adding a drawingInfo configuration to the layer allows to set the visual representation of this data.
If you are using a third-party URL or GeoJSON content, ensure your usage is in compliance the provider's terms of use.
The following table provides the specific configurable options available for this layer:
|
Property |
Type |
Description |
|---|---|---|
|
asImage [Optional] |
Boolean |
Defines vector data is rendered client-side, to an image. This provides great performance during panning and zooming, but pixels are scaled during zoom animations. |
|
assetNameTemplate [Optional] |
String |
Defines template string to generate each feature asset name which is used to set CurrentAsset control property when clicked. When merge is enabled, the generated asset name is used to match the properties derived from the Features control property. |
|
assetZoom [Optional] |
String |
Defines zoom level to set when an asset in this layer is selected via CurrentAsset control property. Attribute templates can be used to get this value from a feature property ({property}). |
|
centerOnClick [Optional] |
Boolean |
Centers the map on a feature when clicked. |
|
drawingInfo [Optional] |
DrawingInfo |
Provides drawing, labeling, and transparency information for the layer. For more information, refer DrawingInfo. |
|
featureReduction [Optional] |
FeatureReduction |
Provides options for reducing the number of features in the view by aggregating them to clusters. For more information, refer Feature Reduction. |
|
merge [Optional] |
Boolean |
Enables feature merging capacity for this layer. |
|
popup [Optional] |
Popup |
Defines layer popup configuration. For more information, refer Popup. |
|
type |
custom |
A type of Layer. |
|
url |
string |
Defines feature Layer URL |
|
zoomOnClick [Optional] |
Boolean |
Sets the assetZoom level to the map when a feature is clicked. |
Examples of GeoJSON
Below is an example of a GeoJSON layer with real-time data from the USGS:
-
Configuration and map preview
-
Configuration JSON string
{
"title": "geojson earthquakes",
"type": "geojson",
"url": "https://earthquake.usgs.gov/earthquakes/feed/v.0/summary/all_month.geojson",
"isBaseMap": false,
"attributions": "Map services and data available from U.S Geological Survey, National Geospatial Program"
}