Data API

The Data API is a single read-only GraphQL endpoint at https://data.mountaya.com/graphql. It answers routing and geospatial questions as structured data you render however you like: compute directions between waypoints, generate route suggestions that hit a target distance, draw reachability isochrones, build travel-time matrices, geocode places, list points of interest, read the terrain itself, and analyze the surface and slope of any geometry.

Every request is a POST carrying a publishable key with the data scope in X-API-Key and a session token in X-Session-Token; see authentication to mint one from your key pair. There are no mutations: the API only reads.

What you can compute

Fourteen queries, in four families.

• Routing. directions between waypoints, suggestions shaped to a target distance and ascent, isochrones for reachable area, and a matrix of travel times or distances between locations.
• Places. geocode free text into named places, reverseGeocode a coordinate, list pois in an area, and run a unified search across places, POIs, ways, and your own itineraries, collections, and zones.
• Itineraries. itinerary to read one of your saved itineraries in full, and exportItinerary to prepare it as a GPX, KML, KMZ, GEOJSON, CSV, FIT, or TCX download.
• Analysis and terrain. analyzeGeometry to classify the surface, way type, and slope of an existing line, and terrainSamples, terrainProfile, and terrainGrid to read elevation, slope, and aspect at points, along a line, or across an area.

All coordinates are [longitude, latitude] in WGS 84, distances are in meters, durations in seconds, elevations in meters above sea level, and gradients in degrees.

Explore the queries

Browse the schema and run queries live in the playground, or download the full GraphQL SDL to generate types and explore it in your own tooling.