Displays Maptiles
Stream Displays modeled-exposure geometry as Mapbox Vector Tiles through a grant-based access pattern: discover tilesets, mint a grant, render in MapLibre.
Displays Maptiles delivers the Displays modeled-exposure geometry as Mapbox Vector Tiles (MVT) for direct rendering in MapLibre GL and compatible map clients. It is the same inventory geometry that backs the Displays On Demand asset library, served through the Motionworks API v2 tile surface.
Access pattern
The surface follows the Motionworks vector-tile grant pattern, shared with Paths, Places, Placecast, Markets Reference, and Popcast Anytime maptiles:
- Discover the published tilesets with GET /v2/displays/tiles/tilesets. This endpoint is public and free (0 credits).
- Mint a grant with POST /v2/displays/tiles/grants. Your organization must be licensed for the
oohdisplays.displays.inventory_tilesfeature. Grant management calls are free. - Render the tiles with the grant's TileJSON document wired into your map client; see Rendering Displays tiles in MapLibre GL. Tile fetches are metered at 1 credit per 1000 tiles.
What is covered
Six modeled-exposure layers, all updated as new Displays releases ship:
| Layer slug | Geometry | Contents |
|---|---|---|
faces | Points | Display face points (the individual display locations) |
viewsheds | Polygons | Modeled OOH viewshed polygons (the area from which a face can be seen) |
paths_vehicle | Lines | Vehicle exposure path lines feeding roadside faces |
paths_pedestrian | Lines | Pedestrian exposure path lines |
gates_vehicle | Points | Modeled vehicle gate points |
gates_pedestrian | Points | Modeled pedestrian gate points |
All six layers are gated by the single bundled oohdisplays.displays.face_point_tiles entitlement; a grant can subscribe to any subset of the six slugs in one mint.
Displays tilesets use undated layer names: the tile service resolves the latest published snapshot server-side as new modeled releases ship, so a grant keeps pointing at current data without a re-mint (the X-MW-Snapshot response header carries the literal static).
Licensing and cost
Tile access is gated by the oohdisplays.displays.inventory_tiles and oohdisplays.displays.face_point_tiles entitlements; your organization must also be on a metered billing rail. Grant CRUD, TileJSON fetches, and discovery are free; tile bytes cost 1 credit per 1000 tiles served. Details in Licensing and cost for Displays maptiles.
See also
- Displays family landing - the Displays family overview
- Displays On Demand - the asset library product, lifecycle, and endpoint map
- Motionworks API reference: Displays - full OpenAPI reference for the Displays tile endpoints
- The live console explorer at
/console/and the tile access-pattern overview at/cx/vector-tiles/
Updated about 1 hour ago