Get Reports (MVT)
Get Reports (MVT)
/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 tofalse.
Layers
- user_reports: Point features for hazard reports.
- user_reported_bathymetry (when
includeBathymetry=true): LineString segments with a per-segmentdepthvalue 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)