Geocodificar endereços por API

Transforme um endereço ou nome de lugar em latitude, longitude e endereço completo com CEP, cidade e estado, com dados do OpenStreetMap. Consulta gratuita.

Peça ao seu agente

Tenho 200 endereços de clientes nesta planilha. Pegue a latitude e a longitude de cada um e marque os que não forem encontrados ou ficarem fora do Brasil.

Cole no Claude, no ChatGPT ou em outro agente conectado à Superpowers.

Falhas não são cobradasPronto para usarFunciona com seu agente de IA

O que você recebeDe uma consulta real em 11/10/2026 · Photon (dados do OpenStreetMap)

Resultado de duas consultas reais

Onde fica a Avenida Paulista, 1578, em São Paulo?

Museu de Arte de São Paulo (MASP), Av. Paulista, 1578, Bela Vista, CEP 01310-200: latitude -23,5615, longitude -46,6560.
Na mesma busca veio antes um ponto de ônibus na Avenida Paulista, a cerca de 60 metros; por isso cada resultado traz o tipo de lugar.
Uma busca por "Mercado Municipal, Belo Horizonte" achou o Mercado Central (Av. Augusto de Lima, 744, Centro). Cada consulta levou menos de um segundo.

Resposta encurtada: 2 dos 3 resultados, em outra ordem (run_bWKX9YXJssk4hQ). © colaboradores do OpenStreetMap.

O que vem na resposta

O que você recebe em cada consulta, venha de qual fonte vier.

Nome do lugar, quando tem, e o tipo (museu, ponto de ônibus, número de casa, rua...)
Rua e número
Bairro, cidade e estado
CEP e país
Latitude e longitude
Identificador do lugar no OpenStreetMap

Fontes

Mesma entrada e mesma saída em todas. Taxa de sucesso dos últimos 30 dias aparece a partir de 5 consultas reais.

Fonte	Preço por consulta	Sucesso	Situação
Photon (OpenStreetMap)	Grátis	100%	Disponível

Perguntas frequentes

De onde vêm os dados?

Do OpenStreetMap, pelo Photon, um geocodificador aberto. A cobertura no Brasil é boa em capitais e cidades grandes e varia em ruas pequenas e áreas rurais.

Como escolho o resultado certo?

Peça até 10 resultados e confira o tipo, a cidade e o país de cada um. Na busca por um mercado de Belo Horizonte, o terceiro resultado era uma loja em Portugal; filtre por countrycode BR quando só interessa o Brasil.

Tem limite de uso?

As chamadas são espaçadas em cerca de uma por segundo e buscas repetidas vêm do cache. Para listas grandes, o agente envia uma por vez; se a fonte estiver ocupada, o erro diz que pode tentar de novo.

Quanto custa?

A consulta é gratuita. Você só precisa de uma conta para ter a chave de API; os US$5 de crédito de boas-vindas servem para as ferramentas pagas.

Como o meu agente usa?

Adicione o servidor MCP da Superpowers no Claude, Cursor, Codex ou ChatGPT e peça em linguagem natural, ou chame POST /v1/run com a ferramenta photon.geocode.

Para desenvolvedoresRequisição da API, resposta completa, campos e configuração MCP

Passe um endereço ou o nome de um lugar e receba a latitude, a longitude e o endereço completo, com rua, número, bairro, cidade, estado e CEP. Consulta gratuita, pela API ou pelo seu agente de IA.

Campos da resposta

results[].name / typeNome do lugar, quando tem, e o tipo (museu, ponto de ônibus, número de casa, rua...)

results[].street / housenumberRua e número

results[].district / city / stateBairro, cidade e estado

results[].postcode / country / countrycodeCEP e país

results[].lat / lonLatitude e longitude

results[].osmIdentificador do lugar no OpenStreetMap

Requisição

curl -X POST https://superpowers.tools/v1/run \
  -H 'Authorization: Bearer $SUPERPOWERS_KEY' \
  -H 'content-type: application/json' \
  -d '{"tool":"photon.geocode","idempotency_key":"example-1","input":{"query":"Avenida Paulista 1578, São Paulo","limit":3}}'

Resposta normalizada

Consulta feita em 11/10/2026 pela Photon (dados do OpenStreetMap), respondida em 760 ms. Resposta encurtada: 2 dos 3 resultados, em outra ordem (run_bWKX9YXJssk4hQ). © colaboradores do OpenStreetMap.

{
  "results": [
    {
      "name": "Museu de Arte de São Paulo",
      "street": "Av. Paulista",
      "housenumber": "1578",
      "district": "Bela Vista",
      "city": "São Paulo",
      "state": "São Paulo",
      "country": "Brasil",
      "countrycode": "BR",
      "postcode": "01310-200",
      "type": "museum",
      "lat": -23.5614961,
      "lon": -46.6559677,
      "osm": "W/1370081491"
    },
    {
      "name": "Avenida Paulista, 1578",
      "street": "Avenida Paulista",
      "housenumber": "1600",
      "district": "Jardim Paulista",
      "city": "São Paulo",
      "state": "São Paulo",
      "country": "Brasil",
      "countrycode": "BR",
      "postcode": "01311-200",
      "type": "bus_stop",
      "lat": -23.5616836,
      "lon": -46.6565685,
      "osm": "N/5629326001"
    },
    "…"
  ]
}

Configuração MCP

Adicione o servidor MCP no Claude, Cursor ou outro cliente e peça em linguagem natural.

Claude Code

claude mcp add --transport http superpowers https://superpowers.tools/mcp \
  --header "Authorization: Bearer $SUPERPOWERS_KEY"

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "superpowers": {
      "url": "https://superpowers.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SUPERPOWERS_KEY}"
      }
    }
  }
}

Codex

codex mcp add superpowers --url https://superpowers.tools/mcp \
  --bearer-token-env-var SUPERPOWERS_KEY

Comece com US$5 de crédito

Esta consulta é gratuita; o crédito serve para as outras ferramentas. Sem cartão para começar.

Criar conta