Get Reports (MVT)

Get Reports (MVT)

GET

/api/v1/user-reports/tiles/{z}/{x}/{y}.mvt

Description

Returns active (non-deleted, non-expired) user reports intersecting the given map tile as a Mapbox vector tile (MVT). With includeBathymetry=true, the same tile also includes crowdsourced bathymetry track line features.

This is the tile URL used by the userReports source when showUserReports=true is set on the style (which requests bathymetry as well). Hazard report feature properties include report type, vote counts, label, optional description, and is_owner for the calling token.

Authentication

Requires a Bearer token in the Authorization header or a token query parameter.

Path Parameters

  • z: Tile zoom level.
  • x: Tile column.
  • y: Tile row.

Query Parameters

  • includeBathymetry (Optional): If true, also include bathymetry track line features in the tile. Defaults to false.

Layers

  • user_reports: Point features for hazard reports.
  • user_reported_bathymetry (when includeBathymetry=true): LineString segments with a per-segment depth value and track properties: platform_name, start_time, end_time, created_at, point_count, min_depth, max_depth, length_m.

Tiles omit report and bathymetry data below the style min zoom (z < 11).

Error Responses

  • 400 Bad Request: Invalid tile coordinates.
  • 401 Unauthorized: Token is missing or invalid.
Example Request
GET https://api.vectorcharts.com/api/v1/user-reports/tiles/12/1240/1515.mvt?token=<token>&includeBathymetry=true

Example Response
Status Code: 200 OK
Content-Type: application/vnd.mapbox-vector-tile
(binary Mapbox Vector Tile)
VectorCharts.com © 2026, Zydro Marine Technologies, Inc. · vectorcharts.com