Get GeoJSON Tile

Get GeoJSON Tile

GET

/api/v2/tiles/data-geojson-v1/{z}/{x}/{y}.json

Description

Returns the raw nautical chart data for the given XYZ tile as a GeoJSON FeatureCollection. Use this endpoint to consume chart features programmatically (for example, to overlay them in a custom renderer, run spatial queries, or feed them into a navigation app).

The features are reconciled across all ENC cells overlapping the tile: higher-resolution local cells cover and clip data from lower-resolution summary cells. Each feature’s properties include a layerId (the S-57 layer name, such as LNDARE or DEPCNT) and an attributes object with the S-57 attributes for that feature.

Authentication

This endpoint accepts a Bearer token in the Authorization header or a token query parameter. See Authentication for details.

Path Parameters

  • z: Zoom level. Must be 10 or higher to keep the response size bounded.
  • x: Tile column.
  • y: Tile row.

Response

On success, returns a GeoJSON FeatureCollection. If no chart data overlaps the tile, the endpoint returns 404 Not Found rather than an empty collection.

Error Responses

  • 400 Bad Request: z is below 10.
  • 401 Unauthorized: The token is missing or not valid.
  • 404 Not Found: No chart data overlaps the requested tile.
Example Request
GET https://<your-host>:9909/api/v2/tiles/data-geojson-v1/12/1240/1515.json
Authorization: Bearer <token>

Example Response
Status Code: 200 OK
Content-Type: application/json

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [-122.388, 37.790]
            },
            "properties": {
                "layerId": "LNDARE",
                "attributes": { ... }
            }
        },
        ...
    ]
}
VectorCharts.com © 2024, Zydro Marine Technologies, Inc. · vectorcharts.com