Skip to main content

​
Endpoints

MethodPathDescription
GET/v1/places/autocompleteReturn Google Places predictions for cities or airports
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.

​
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.