/v1/tiles/vector/{z}/{x}/{y}.mvt Serve fully-styleable MVT tiles for roads, terrain, water, land use, buildings, and nautical layers from Farun's global spatial dataset.
Standard Mapbox Vector Tile format. Works with MapLibre GL, Mapbox GL JS, and any MVT-compatible renderer. Style every layer client-side - no raster lock-in, no re-requesting tiles when you change the visual.
# Fetch a single MVT tile at zoom 14
curl "https://api.farun.io/v1/tiles/vector/14/8321/5674.mvt" \
-H "X-RapidAPI-Key: YOUR_KEY" \
-H "X-RapidAPI-Host: farun-maps.p.rapidapi.com" \
--output tile.mvt
# Response: binary protobuf (.mvt)
# Pass directly to MapLibre GL or Mapbox GL JSFormat
MVT / protobuf
Layers
Road, water, terrain, nautical…
Zoom
0 – 16
What's in the tile
Each tile is a self-contained protobuf of vector features. Style them however you want client-side - no round-trip to re-request a tile when you change a colour or toggle a layer.
Motorways, trunk roads, primary, secondary, residential, service tracks, and ferry routes with classification metadata for style rules.
Ocean, rivers, lakes, reservoirs, and wetlands with water body type metadata. Essential for marine and flood-risk applications.
Forest, farmland, residential zones, industrial areas, parks, and protected areas from OSM classification + Farun data enrichment.
Building footprints with height data where available for 3D extrusion. Available from zoom 13.
Elevation contours derived from 30m SRTM data. Style by elevation band for hillshading, slope analysis, and topographic overlays.
Depth contours, buoys, shipping lanes, anchorages, and restricted zones. Activated by including the nautical layer in your style spec.
Who uses it
Vector tiles give developers complete control over how the map looks and behaves. The tile is data - your renderer decides the style. That means your brand colours, your layer order, your label language, your hidden layers.
Fleet & Logistics
Render roads in your brand palette. Suppress irrelevant layers (parks, tourism, buildings) to keep dispatch maps clean and focused on what drivers see.
Marine & Coastal
Combine the road layer with nautical layer for tow-vehicle-to-helm continuity. Build chart plotting apps that show depth contours, buoys, and shipping lanes without a separate chart tile server.
Agriculture & Land
Style farmland, forest, and land-use layers by crop type or risk rating. Combine with the elevation contour layer for slope-aware field boundary maps.
Insurance & Real Estate
Overlay water body layers and terrain contours on property maps for flood-risk assessment. Toggle building footprints for underwriting workflows.
Embedded Displays
Use raster tiles when the target hardware can't run WebGL. Use vector tiles on capable devices for crisp, resolution-independent rendering on any pixel density.
Developer Tools
Build style editors, map preview tools, and no-code mapping products on top of Farun tiles. The MVT format is the same spec as Mapbox existing tooling works without modification.
Endpoint reference
https://api.farun.io/v1/tiles/vector/{z}/{x}/{y}.mvt Path parameters
z
req
x
req
y
req
Query parameters
layers style Response
200 application/x-protobuf Binary MVT tile. Pass directly to MapLibre GL / Mapbox GL. 204 No content Tile exists but contains no features at this zoom level. 400 Bad request Invalid z/x/y combination or out-of-range coordinates. 401 Unauthorized Missing or invalid RapidAPI key. 429 Rate limited Request rate exceeds your plan. Upgrade on RapidAPI. Integration example
import maplibregl from 'maplibre-gl';
const map = new maplibregl.Map({
container: 'map',
style: {
version: 8,
sources: {
farun: {
type: 'vector',
tiles: [
`https://api.farun.io/v1/tiles/vector/{z}/{x}/{y}.mvt`
],
// pass key via query param or proxy
},}
},
layers: [
{
id: 'road',
type: 'line',
source: 'farun',
'source-layer': 'road',
paint: {
'line-color': '#ea580c',
'line-width': 1.5
}
}
]
}
});Format
MVT (Mapbox Vector Tile spec)
Encoding
Protobuf binary
Renderer
MapLibre GL, Mapbox GL, Deck.gl
Style
Client-side via style spec
Zoom range
0 - 16
Coordinate
EPSG:3857 (Web Mercator)
Often used together
Resolve a search query to coordinates, then fly the map to that location.
Generate reachability polygons to render as fill layers on the same map canvas.
Calculate route geometry to overlay on your vector map as a GeoJSON layer.
Query terrain altitude along a path and overlay the profile alongside the map view.
Start building
Subscribe on RapidAPI for instant key access. The free tier covers 10,000 vector-tile requests per day enough to build and test a complete map integration.