A viewer link combines a data reference (Layer or Bookmark) with an optional access control layer (Token). Using this structure, you can generate direct viewer links that reference either a single layer or a complete map configuration.
To share a specific layer, construct a viewer URL using the layer ID:
https://app.ellipsis-drive.com/view?pathId={ID of your layer}To share a map containing multiple layers:
Create a bookmark that includes the desired layers using this API call or this Python function.
Once you have created the bookmark, the API will return the bookmark ID
Use the bookmark ID in the viewer URL:
https://app.ellipsis-drive.com/view?pathId={ID of the bookmark}Bookmarks represent a complete map state, including selected layers and configuration.
If the data is not available via link sharing, users will be required to log in.
To provide direct access, you can generate a signed URL using an access token. Tokens are typically used when link sharing is disabled but controlled external access is still required.
After generating a token using this API endpoint or this Python function, append it to the viewer URL:
Signed URLs allow controlled access without requiring user authentication.
Access tokens define how the shared link can be used. Depending on how the token is created, it can:
Grant access to specific layers or bookmarks
Be scoped to a limited set of actions or endpoints
Expire after a defined period
Be tied to a user, service, or system context
This allows you to share data securely while maintaining control over access and usage.
Layer IDs reference individual datasets
Bookmark IDs reference composed map views
Tokens define access control on top of the data reference
Last updated
https://app.ellipsis-drive.com/view?pathId={ID of the bookmark}&token={your created access token}}