# Maps

Places for an address or a name, the address at a point, places nearby, routes, travel times and map tiles.

Scopes for this area: `maps:read`, `maps:write` and `maps:admin`.

5 operations.

## place

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| GET | `/maps/geocode` | Places for an address or a name, best first, with coordinates and a short context line; prefer places near a point or in a country. | read | `rivier maps place geocode` |
| GET | `/maps/reverse` | The address at a point. | read | `rivier maps place reverse` |
| GET | `/maps/search` | Places of a kind or a name (a pharmacy, a cafe) near a point or inside a box, nearest first. | read | `rivier maps place search` |

## route

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| POST | `/maps/route` | A route through two to 25 points by car, on foot or by bicycle: distance, time, the line (polyline6) and each leg. | read | `rivier maps route get` |
| POST | `/maps/matrix` | Travel times and distances from each source to each target (up to 25 by 25, 400 cells), for choosing the nearest or planning a round. | read | `rivier maps route matrix` |