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

# Places API

> Search for cities and airports with Google Places-powered autocomplete.

## Endpoints

| Method | Path                      | Description                                             |
| ------ | ------------------------- | ------------------------------------------------------- |
| GET    | `/v1/places/autocomplete` | Return Google Places predictions for cities or airports |

<Info>
  Authentication: send your Voyant API key via `Authorization: Bearer`. The service proxies Google Places using your workspace configuration and never exposes your Google API key directly.
</Info>

## Key concepts

* Queries shorter than three characters return an empty list to avoid unnecessary API calls.
* Use `kind=city` or `kind=airport` to restrict the type of predictions returned from Google Places.
* Responses include `place_id`, a human-readable `description`, and a `structured_formatting` payload suitable for UI display.
* The API gracefully degrades: Google errors are surfaced in the response while keeping `predictions` as an empty array.