Skip to main content

​
Visão geral

Retorna informações detalhadas sobre um lugar específico, incluindo endereço completo, coordenadas geográficas e componentes de endereço.

​
Endpoint

GET /api/maps/place

​
Parâmetros de Query

ParâmetroTipoObrigatórioDescrição
place_idstringSimID do lugar obtido do autocomplete

​
Exemplo de Requisição

curl -H "X-API-Key: sua_chave_aqui" \
  "https://api.fretamaps.com.br/api/places/details?place_id=ChIJ0WGkg4FEzpQRrlsz_whLqZs"

​
Exemplo de Resposta

{
  "place_id": "ChIJ0WGkg4FEzpQRrlsz_whLqZs",
  "name": "São Paulo",
  "formatted_address": "São Paulo, SP, Brasil",
  "geometry": {
    "location": {
      "lat": -23.5505,
      "lng": -46.6333
    },
    "viewport": {
      "northeast": {
        "lat": -23.3566,
        "lng": -46.3654
      },
      "southwest": {
        "lat": -23.7044,
        "lng": -46.9012
      }
    }
  },
  "address_components": {
    "route": "",
    "state": "São Paulo",
    "state_short": "SP",
    "city": "São Paulo",
    "district": "",
    "postal_code": ""
  }
}

​
Estrutura de Resposta

​
place_id
string
required
Identificador único do lugar
​
name
string
required
Nome do lugar
​
formatted_address
string
required
Endereço formatado completo
​
geometry
object
required
Informações geográficas do lugar
​
geometry.location
object
required
Coordenadas do lugar
​
geometry.location.lat
number
required
Latitude
​
geometry.location.lng
number
required
Longitude
​
geometry.viewport
object
required
Viewport sugerido para exibir o lugar
​
address_components
object
required
Componentes do endereço
​
address_components.route
string
Nome da rua/logradouro
​
address_components.state
string
Nome completo do estado
​
address_components.state_short
string
Sigla do estado (ex: SP, RJ)
​
address_components.city
string
Nome da cidade
​
address_components.district
string
Bairro/distrito
​
address_components.postal_code
string
CEP

​
Headers de Resposta

  • X-Cache: HIT se veio do cache, MISS se foi buscado da API
  • X-Provider: Google ou Here
  • X-Format: Standard

​
Códigos de Status

  • 200 OK - Requisição bem-sucedida
  • 400 Bad Request - Parâmetro place_id não fornecido ou inválido
  • 401 Unauthorized - Autenticação falhou
  • 500 Internal Server Error - Erro ao buscar dados do provedor

​
Notas

  • O place_id pode incluir prefixo do provedor (ex: google:ChIJ0WGkg4FEzpQRrlsz_whLqZs ou here:NT_...).
  • O sistema automaticamente extrai o ID limpo e valida o provedor.
  • Os dados são armazenados em cache para reduzir chamadas à API.