---
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`

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.net/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus.md) · [All operations](https://skmtc.net/clickbus/apis/documenta-o-da-api-de-autentica-o-clickbus/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clickbus/documenta-o-da-api-de-autentica-o-clickbus/revisions/ead7d81fdb28/schema)