Central de Ajuda

Encontre respostas, tutoriais e exemplos para usar o Loccalize.

Início Rápido

1

Crie sua conta

Registre-se gratuitamente e obtenha sua API key

Criar Conta
2

Faça sua primeira requisição

Teste a API com um exemplo simples

Ver Exemplo
3

Explore os endpoints

Conheça todas as funcionalidades disponíveis

Ver Documentação

Categorias de Ajuda

Recursos Adicionais

📚 Documentação

🛠️ Ferramentas

💬 Suporte

Exemplos de Código

🟨

Geocodificação Básica

Converter endereço em coordenadas

🐍

Geocodificação Reversa

Converter coordenadas em endereço

🌐

Busca de Locais

Buscar locais por texto

🟨

Locais Próximos

Encontrar locais próximos a uma coordenada

🔍

Autocomplete de Endereços

Sugestões em tempo real

⚛️

Exemplo React Completo

Hook personalizado para geocodificação

Troubleshooting Avançado

🔍 Diagnóstico de Problemas

Erro 500 - Internal Server Error

Verifique se os parâmetros estão corretos e tente novamente em alguns minutos.

Timeout - Requisição muito lenta

Implemente retry com backoff exponencial e considere usar cache local.

Resultados inconsistentes

Verifique a qualidade dos dados de entrada e use o campo 'confidence' para filtrar.

🛠️ Ferramentas de Debug

Status da APIVerificar
Teste de ConectividadeTestar
Validador de API KeyValidar
Monitor de UsoAcessar

Guias de Integração

⚛️ JavaScript/Fetch

Integração simples usando fetch API nativo do JavaScript.

fetch('/api/geocode?address=...')
.then(res => res.json())
.then(data => console.log(data))
  • • Sem dependências externas
  • • Suporte a async/await
  • • Tratamento de erros
  • • Cache local opcional

🟢 Node.js/Express

Integração backend usando Node.js com Express.

const response = await fetch(
'https://api.loccalize.com.br/geocode'
)
  • • Middleware personalizado
  • • Rate limiting
  • • Logs estruturados
  • • Variáveis de ambiente

🐍 Python/Requests

Integração Python usando a biblioteca requests.

import requests
response = requests.get(
'https://api.loccalize.com.br/geocode'
)
  • • Biblioteca requests
  • • Tratamento de exceções
  • • Timeout configurável
  • • Session reutilizável

☕ Java/HttpClient

Integração Java usando HttpClient nativo (Java 11+).

HttpClient client = HttpClient
.newHttpClient();
HttpRequest request = ...
  • • HttpClient nativo
  • • CompletableFuture
  • • Connection pooling
  • • Retry automático

🔷 C#/HttpClient

Integração .NET usando HttpClient com async/await.

using var client = new HttpClient();
var response = await client
.GetAsync("https://api...");
  • • HttpClient reutilizável
  • • Async/await pattern
  • • Dependency injection
  • • Polly para resilência

🐘 PHP/cURL

Integração PHP usando cURL ou file_get_contents.

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, ...);
$response = curl_exec($ch);
  • • cURL ou file_get_contents
  • • Tratamento de erros
  • • Headers personalizados
  • • Timeout configurável

Não encontrou o que procurava?

Nossa equipe de suporte está pronta para ajudar com qualquer dúvida específica.