---
title: "Detailed points of interest within a travel-time isochrone"
description: "Returns individual POIs reachable within `range` (seconds of travel time) of a coordinate for the given travel `profile`, grouped into Aireon amenity clusters."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.aireon.ch/llms.txt
> Use this file to discover all available pages before exploring further.

Path: RES API (public) › Score

`GET /score/poi-details-driving-distance`

Returns individual POIs reachable within `range` (seconds of travel time) of a coordinate for the given travel `profile`, grouped into Aireon amenity clusters.

## Authentication

- `ResApiToken`, apiKey, in header, header `token`

## Query parameters

- `lat` (`getPoiDetailsDrivingDistance.query.lat`; number, required): WGS84 latitude.
- `lng` (`getPoiDetailsDrivingDistance.query.lng`; number, required): WGS84 longitude.
- `range` (`getPoiDetailsDrivingDistance.query.range`; integer, required): Isochrone range, in seconds of travel time.
- `profile` (`getPoiDetailsDrivingDistance.query.profile`; string, optional): OpenRouteService travel profile (e.g. `driving-car`, `cycling-regular`, `foot-walking`).
  - default `"driving-car"`

## Code samples

### cURL

```bash
curl --request GET \
  --url 'https://res.aireon.ch/score/poi-details-driving-distance?lat=0&lng=0&range=0' \
  --header 'token: <token>'
```

### TypeScript

```typescript
const url = 'https://res.aireon.ch/score/poi-details-driving-distance?lat=0&lng=0&range=0';
const options = {method: 'GET', headers: {token: '<token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://res.aireon.ch/score/poi-details-driving-distance?lat=0&lng=0&range=0"

headers = {"token": "<token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

## Responses

### 200

POIs grouped by amenity cluster.

#### Example

```json
{
  "property1": [
    {
      "name": "string",
      "distance": 0,
      "category_name": "string",
      "category_group": "string",
      "location_index": 0,
      "position": {
        "lat": 0,
        "lng": 0
      }
    }
  ],
  "property2": [
    {
      "name": "string",
      "distance": 0,
      "category_name": "string",
      "category_group": "string",
      "location_index": 0,
      "position": {
        "lat": 0,
        "lng": 0
      }
    }
  ]
}
```

### 400

Invalid request.

#### Example

```json
{
  "error": "string",
  "message": "string"
}
```

- `error` (`getPoiDetailsDrivingDistance.response.400.error`; string, required): Human-readable error description.
- `message` (`getPoiDetailsDrivingDistance.response.400.message`; string, optional): Optional underlying error message.

### 401

Authentication token missing (plain-text body).

#### Example

```text
Missing Token
```

### 403

Authentication token invalid (plain-text body).

#### Example

```text
Wrong Token
```

### 500

Server error.

#### Example

```json
{
  "error": "string",
  "message": "string"
}
```

- `error` (`getPoiDetailsDrivingDistance.response.500.error`; string, required): Human-readable error description.
- `message` (`getPoiDetailsDrivingDistance.response.500.message`; string, optional): Optional underlying error message.


Source: https://docs.aireon.ch/res/get-poi-details-driving-distance/index.md