Layers
Uploading a file or URL
Check our Upload Anything docs to see what URLs are supported.
The /upload
endpoint can be used for both URL and file uploads:
For URL uploads, simply making a single
POST
request to the upload endpoint is enoughFor file uploads, the response of the initial
POST
request will include a target URL and some pre-signed attributes, which will be used to upload the new file to Amazon S3.
The ID of the map to upload the layer to.
A public URL containing geodata to import, in place of uploading a file.
(Image uploads only) The latitude of the image center.
(Image uploads only) The longitude of the image center.
The display name for the new layer.
(Image uploads only) The zoom level of the image.
UploadResponse
"RShuaEiiRTm19ALxAAf9Ar5B"
The ID of the layer created by this upload. If multiple layers are included in the upload, this is the ID of the first layer in the layer group.
"grxbBVKoRUWKYh77urpGWD"
If provided, the presigned attributes to attach to the post request
If provided, the URL to post the file to
This endpoint is used to create a layer, and obtain a pre-signed url to upload the layer files to S3.
Uploading the file to Amazon S3
Uploading a file is a single function call using the felt-python
library.
Layer files aren’t uploaded directly to the Felt API. Instead, they are uploaded by your client directly to an S3 bucket.
You will receive a single set of URL and pre-signed params to upload the file. Only a single file may be uploaded — if you wish to upload several files at once, consider wrapping them in a zip file.
To upload the file using the pre-signed params, you must perform a multipart upload, and include the file contents in the file
field:
Refreshing a layer
Refreshing a file is a single function call using the felt-python
library.
After uploading a file or URL, you may want to update the resulting layer with some new data. The process is quite similar to the above:
For URL uploads, simply making a single
POST
request to the refresh endpoint is enoughFor file uploads, the response of the initial
POST
request will include a URL and some presigned attributes, which will be used to upload the new file to Amazon S3. See Uploading the file to Amazon S3 for more details.
The ID of the map hosting the layer to refresh
The ID of the layer to refresh
UploadResponse
"RShuaEiiRTm19ALxAAf9Ar5B"
The ID of the layer created by this upload. If multiple layers are included in the upload, this is the ID of the first layer in the layer group.
"grxbBVKoRUWKYh77urpGWD"
If provided, the presigned attributes to attach to the post request
If provided, the URL to post the file to
Deleting a layer
The ID of the map to delete the layer from
The ID of the layer to delete
No Content
Styling layers
Update a layer's style
A layer's style may be updated by providing a new Felt Style Language object. Learn more in the guide:
Styling layersThe ID of the map where the layer is located
The ID of the layer to update the style of
The new layer style, specified in Felt Style Language format
Dataset
"k441enUxQUOnZqc1ZvNsDA"
A sort order key used for ordering layers and layer groups in the legend
The Felt Style Language style for the layer
The tile URL for this layer
Managing layers
Get all the layers on a map
Get the details of all the layer on the map that are not within a layer group.
Layers
"k441enUxQUOnZqc1ZvNsDA"
A sort order key used for ordering layers and layer groups in the legend
The Felt Style Language style for the layer
The tile URL for this layer
Get a single layer
Get the details of a single layer on the map. These details include:
Name of the layer
Upload status and progress
Style, expressed in the Felt Style Language
Other metadata, such as the geometry type, visibility state in the legend, etc
Layer
"k441enUxQUOnZqc1ZvNsDA"
A sort order key used for ordering layers and layer groups in the legend
The Felt Style Language style for the layer
The tile URL for this layer
Updating a layer's details
Update a layer's name or move it into or out of a layer group.
To move a layer into a group, set the layer_group_id
to the id
of the layer group you want to move the layer into. To move a layer out of a group, set the layer_group_id
to null
.
"nOFB8jOFSne1DuDr2uFn4A"
"KFFhKAbvS4anD3wxtwNEpD"
"My Layer"
"A very interesting dataset"
Layer
"k441enUxQUOnZqc1ZvNsDA"
A sort order key used for ordering layers and layer groups in the legend
The Felt Style Language style for the layer
The tile URL for this layer
Layer groups
Get details of a layer group
Layer Group
"v13k4Ae9BRjCHHdPP5Fcm6D"
A sort order key used for ordering layers and layer groups in the legend
Delete a layer group
The ID of the map to delete the layer group from
The ID of the layer group to delete
No Content
Create or update layer groups
Provide an array of layer group objects to create new groups or update existing ones.
For each layer group object, including an existing ID will result in the group's details (name, subtitle and legend order) being updated. If no layer group ID is provided (or a non-existent one is provided), a new layer group will be created.
"OI22G7wJRzOo2p1RQeHIPB"
"My Layer Group"
"A very interesting group"
LayerGroup
"v13k4Ae9BRjCHHdPP5Fcm6D"
A sort order key used for ordering layers and layer groups in the legend
Layer library
Listing layers
List all layers in your workspace's Library
LayerLibrary
Publishing a layer
Publish a layer to your workspace's library
The ID of the map where the layer is located
The ID of the layer to publish
The name to publish the layer under
"My Layer"
Publish layer response
"k441enUxQUOnZqc1ZvNsDA"
A sort order key used for ordering layers and layer groups in the legend
The Felt Style Language style for the layer
The tile URL for this layer
Publishing a layer group
Publish a layer group to your workspace's library
The ID of the map where the layer group is located
The ID of the layer group to publish
The name to publish the layer group under
"My Layer Group"
Publish layer grup response
"v13k4Ae9BRjCHHdPP5Fcm6D"
A sort order key used for ordering layers and layer groups in the legend
Downloading layers
Get a link to export a layer as a GeoPackage (vector layers) or GeoTIFF (raster layers).
The ID of the map where the layer is located
The ID of the layer to export
Export link
Last updated