Geocode an address, then route to it

Before you start, you need an API key.

Search for the place

Send free text in q. Use near_text when a name could match several places, because it ranks results near a landmark or district you name. If your app knows where the user is, follow Search near your user instead.

bash

curl -s -H "X-API-Key: $QUADRUPER_KEY" \
  'https://quadruper.com/v2/geocode?q=SM%20City&near_text=Jaro%2C%20Iloilo%20City&limit=3'

Check what came back

Read results[0] and confirm it's the place you meant. When you send near_text, reference shows the place that text resolved to. This is an example response:

json

{
  "results": [{
    "source": "osm",
    "id": "node/123456",
    "name": "SM City Iloilo",
    "label": "SM City Iloilo, Mandurriao, Iloilo City",
    "location": [122.5517, 10.7139],
    "category": "shop",
    "type": "mall",
    "address": { "district": "Mandurriao", "city": "Iloilo City", "country_code": "ph" }
  }],
  "reference": { "label": "Jaro, Iloilo City", "location": [122.563, 10.727] },
  "attribution": [{ "source": "osm", "text": "© OpenStreetMap contributors", "license": "ODbL-1.0" }]
}

No match returns 200 with "results": []. If the near_text place can't be found, you get 422 reference_not_found, so ask the user to rephrase it.

Pass the location to the route

location is already [lng, lat], the same order that points takes. Don't swap it.

bash

curl -s -X POST -H 'Content-Type: application/json' -H "X-API-Key: $QUADRUPER_KEY" \
  -d '{"points":[[122.5621,10.7202],[122.5517,10.7139]],"steps":true}' \
  https://quadruper.com/v2/route

Check your result

The response has one route, with a steps list on each leg. If a point has no road nearby, you get 422 point_not_snapped, and details.point_index tells you which point it was. POST /v2/route documents every field.