Get started
Places

Points of interest

Points of interest

The pois query of the Data API. Every request is a POST to https://data.mountaya.com/graphql with a publishable key and a session token: see Authentication.

pois

POST
/graphql

List points-of-interest matching one or more categories inside a bounding box or a buffered geometry. Returns POIs ranked by relevance and, when a buffered area is provided, annotated with their distance to the geometry. Neither area is required: with neither, the categories are looked up with no geographic filter.

Arguments

input

PoisInput!

required

The area to search, the categories to return, and how many results to cap at.

Returns

pois

PoisResult!

required

Result of a points-of-interest query.

Errors A field the API refuses is answered 200, its entry in errors beside the data that resolved. See Errors.

curl https://data.mountaya.com/graphql \
  -H "X-API-Key: pk_your_publishable_key" \
  -H "X-Session-Token: sess_your_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query Pois($input: PoisInput!) { pois(input: $input) { count pois { category name point } } }",
    "variables": {
      "input": {
        "bbox": [6.8, 45.85, 6.95, 45.95],
        "categories": ["HUT"],
        "limit": 3
      }
    }
  }'