Map Image API

The Map Image API is the network's first Map API enabling forwarding looking businesses and organizations to use the decentralized map.

API Key

All requests must have your API Key attached as an Authorization header. Please contact us for an API Key.

headers: {
authorization: "Basic <API Key>"
}

Coverage Request

Coverage request queries are free, and they return the available number of files that would be returned for each area you are requesting.

# How much data is available in some area newer than some maximum-age date defined by <lat, lon> degree coordinates and a radius in meters
GET
https://api.hivemapper.com/dashcam-all/ortho/YYYY-MM-DD/coverage/lat/lon/radius
RESP <number files that would be returned by a consumption query>

Coverage Request parameters:

  • Mode

    • Dashcam-all side and front facing mounted dascham imagery at street level

    • Dashcam-ff front facing ground based imagery from dashcam at street level

    • Dashcam-sf side facing mount street level imagery from dashcam at street level

    • Orthoairborne based imagery from drone

  • Date

    • YYYY-MM-DD

  • Coverage area

    • lat/lonand the radiusaround the lat/lon

Retrieve Content

If there is coverage in the area you want and you want to retrieve the content you do so with the Retrieve Content request. Only successful requests to retrieving content incurs an API charge. There are two types of API retrieve requests - one for dashcam ground based imagery and one for aerial

Retrieve Content - Airborne

Hivemapper currently offers high resolution 256x256 L18 tiles with a target GSD less than 6cm/pixel. Hivemapper provides access to its ortho data via a Tile API using Google Maps Tile Coordinates, also known as Slippy Tilenames.

# Via a Tile API using Google Maps Tile Coordinates, also known as Slippy Tilenames.
# Get ortho imagery at <x, y> that's newer than some minimum date YYYY-MM-DD
GET https://api.hivemapper.com/ortho/YYYY-MM-DD/consume/18/x/y.png
--> RESP <raw data>
# This will return the most recent ortho tile imagery file for the desired location
that's newer than some maximum-age collection date, or a 404 if not found.

Additionally, each ortho image is encoded with metadata describing its

  • precise location

In the near future we will also return airborne content in GeoTiff format

Retrieve Content - Street view

Hivemapper currently offers high resolution raw 4k street-level imagery queryable by 256x256 L18 tiles. Hivemapper provides access to its dashcam data via a Tile API using Google Maps Tile Coordinates, also known as Slippy Tilenames.

# Via a Tile API using Google Maps Tile Coordinates, also known as Slippy Tilenames.
# Get all dashcam imagery at <x, y> that's newer than some minimum date YYYY-MM-DD
GET https://api.hivemapper.com/street/YYYY-MM-DD/consume/18/x/y.png
--> RESP <array of signed urls>
# This will return signed urls for the most recent street-level images for the desired location that's newer than some maximum-age collection date, or a 404 if not found.
# Signed urls have a 24 hour TTL
  • street returns both front facing and side facing mounts perspective

  • street-ff only returns front-facing mounted dashcam perspective

  • street-sf only return side facing mounted dashcam perspective

Additionally, each dashcam image is encoded with metadata describing its:

  • precise location

  • mount position (when available)

  • camera intrinsics

  • speed