---
title: "Busca por Localização Geográfica"
method: GET
path: "/partners/api/v4/places/by-location"
tags: ["Lugares"]
---

# Busca por Localização Geográfica

`GET /partners/api/v4/places/by-location`

## Request

- Base URL: `https://platform-bff-partners.stg.clickbus.net`
- URL: `https://platform-bff-partners.stg.clickbus.net/partners/api/v4/places/by-location`
- Auth: HTTP bearer

Serviço que retorna locais encontrados por localização geográfica. Utiliza latitude e longitude ou informações de cidade/estado para encontrar terminais e destinos próximos, facilitando a busca por localização atual do usuário.

## Query parameters

- `name` string
- `cityName` string
- `state` string
- `latitude` string
- `longitude` string
- `radius` number
- `limit` number
- `fields` string

## Headers

- `cloudfront-viewer-city` string, required
- `cloudfront-viewer-country-region` string, required
- `cloudfront-viewer-latitude` string, required
- `cloudfront-viewer-longitude` string, required

## Response `200`

Sucesso. Lista de locais encontrados por localização.

- Place[]
  - `id` number, required: Identificador unico do local
  - `name` string, required: Nome de exibição do local
  - `slug` string, required: Um identificador apresentável, geralmente usado em URLs ou caminhos, como uma sigla
  - `terminal` Terminal, required
    - `id` number, required: Identificador unico do terminal
    - `name` string, required: Nome de exibição do terminal
    - `slug` string, required: Slug do terminal
  - `city` City, required
    - `id` number, required: Identificador unico da cidade
    - `name` string, required: Nome de exibição da cidade
    - `slug` string, required: Slug da cidade
  - `state` State, required
    - `id` number, required: Identificador unico do estado
    - `name` string, required: Nome de exibição do estado
    - `slug` string, required: Slug do estado
    - `code` string, required: Código do estado
  - `country` Country, required
    - `id` number, required: Código unico do país
    - `name` string, required: Nome de exibição do país
    - `slug` string, required: Slug do país
    - `code` string, required: Código do país
  - `latitude` string, required: Latitude do local para geolocalização
  - `longitude` string, required: Longitude do local para geolocalização
  - `weight` number, required: Peso do local para ordenação
  - `latlon` Latlon, required
    - `lat` string, required: Latitude
    - `lon` string, required: Longitude
  - `radius` number, required: Informação de raio do local em metros
  - `useGroupByCity` boolean, required: Se o local usa agrupamento por cidade
  - `boardingPass` boolean, required: Se o local permite cartão de embarque eletronico

## Other responses

- `400`: Requisição inválida
- `401`: Não autorizado - token inválido ou expirado
- `500`: Erro interno do servidor

---

[API](https://skmtc.dev/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus.md) - [All operations](https://skmtc.dev/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus/llms.txt) - [OpenAPI document](https://skmtc.dev/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus/revisions/ead7d81fdb28?raw)
