Lanewise

Quickstart

This guide gets you from zero to your first query: create an API key, define an attribute, store a few POIs and search them by distance.

You need a Lanewise account. Sign up in the dashboard: it creates a team on the Free tiers for you: 50 requests per hour and 1,000 POIs.

1. Create an API key

In the dashboard, open API keys and create a key. Pick the permissions it needs; for this guide, grant every POI, attribute and category permission. The key is shown only once, so store it somewhere safe.

Check that the key works by asking the API about itself:

cURL

curl https://api.lanewise.app/v1/info \
  -H "X-API-KEY: {YOUR_API_KEY}"

2. Define an attribute

Attributes are typed custom fields for your POIs. Create a boolean open attribute so you can filter by it later:

cURL

curl https://api.lanewise.app/v1/attributes \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"name": "open", "type": "boolean"}'

3. Store a POI

Send a name and coordinates, plus any attribute values. Lanewise reverse-geocodes the POI in the background and fills in its address a few seconds later.

cURL

curl https://api.lanewise.app/v1/pois \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mercat de la Boqueria",
    "latitude": 41.3818,
    "longitude": 2.1716,
    "attributes": { "open": true }
  }'

Response

{
  "data": {
    "id": "01J9ZC4Y4B5Q8QD42ZS3ZEV751",
    "name": "Mercat de la Boqueria",
    "latitude": 41.3818,
    "longitude": 2.1716,
    "category": null,
    "attributes": { "open": true },
    "address": {
      "display_name": null,
      "street": null,
      "city": null,
      "country": null,
      "zipcode": null,
      "geocoded_at": null
    },
    "created_at": "2026-09-27T09:12:44.000000Z",
    "updated_at": "2026-09-27T09:12:44.000000Z"
  }
}

4. Query POIs

Find the open POIs within 500 meters of a point. Results include the distance in meters:

cURL

curl -G https://api.lanewise.app/v1/pois \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -d latitude=41.3825 \
  -d longitude=2.1722 \
  -d distance=500 \
  -d "attributes[open]=true"

What's next?