---
title: Routing, Geocoding & Search | Plaza Docs
description: Compute routes, geocode addresses, and search by name within PlazaQL queries.
---

## Routing and navigation

### `route()` — point-to-point routing

Use keyword arguments to specify origin, destination, and optional waypoints:

```
// Simple A to B
$r = route(origin: point(38.9, -77.0), destination: point(38.85, -77.05), mode: "auto");


// Multi-stop route with waypoints
$r = route(
  origin: point(38.9, -77.0),
  waypoints: [point(38.88, -77.02)],
  destination: point(38.85, -77.05),
  mode: "foot"
);
```

Routes are geometry objects — use them in spatial filters:

```
$r = route(origin: point(40.748, -73.993), destination: point(40.755, -73.970), mode: "auto");


// Find gas stations along the route
search(amenity: "fuel")
  .around(distance: 500, geometry: $r);
```

Available modes: `"auto"`, `"foot"`, `"bicycle"`.

### `isochrone()` — travel-time reachability

Find the area reachable within a time limit:

```
// Everything walkable within 10 minutes
$iso = isochrone(center: point(48.85, 2.35), time: 600, mode: "foot");


search(amenity: "pharmacy")
  .within(geometry: $iso);
```

The `time` parameter is in seconds. The result is a polygon you can use with `.within()`.

### Using route results as outputs

Routes and isochrones can also be direct outputs. Named outputs are referenceable — `$$.route` is used as a value in the `.around()` call below:

```
$$.route = route(origin: point(38.9, -77.0), destination: point(38.85, -77.05), mode: "auto");
// $$.route is both an output and a reference used in the next statement
$$.nearby = search(amenity: "fuel")
  .around(distance: 500, geometry: $$.route);
```

## Geocoding and search

### `geocode()` — address to coordinates

```
$results = geocode(query: "1600 Pennsylvania Ave, Washington DC");
```

### `reverse_geocode()` — coordinates to address

```
$addr = reverse_geocode(point: point(38.8977, -77.0365));
```

### `text_search()` — full-text named entity search

```
$hits = text_search(query: "best pizza", limit: 10, focus: point(40.7, -74.0));
```

### `autocomplete()` — search-as-you-type

```
$suggest = autocomplete(query: "coff", limit: 5);
```

### Combining geocoding with spatial queries

```
$addr = geocode(query: "Times Square, New York");


search(amenity: "restaurant")
  .around(distance: 300, geometry: $addr)
  .sort(distance($addr))
  .limit(count: 15);
```