Busca enquanto digita
Ruas, números e lugares conhecidos, com “XV de Novembro” = “15 de Novembro” e “Dr.” = “Doutor”.
Ponto do endereço
Número exato, o vizinho do mesmo lado da rua ou o meio da rua quando não tem número.
Endereço de um ponto
Do GPS do celular para rua, número, bairro, cidade e CEP.
Rotas
Carro, moto, bicicleta e a pé, com distância, tempo e o desenho do trajeto.
De onde vêm os dados
Endereços do Cadastro Nacional de Endereços do IBGE (Censo 2022), ruas e nomes do OpenStreetMap e correções feitas todos os dias pelo GPS dos entregadores do 10leva no momento da coleta e da entrega. A base é atualizada cidade por cidade, em segundo plano.
Toda resposta traz o campo “atribuicao”: mostre esse texto no seu app, junto do mapa ou dos resultados.
Documentação
Base: https://10oferta.com/api/10mapas/v1. Envie a chave no cabeçalho Authorization: Bearer 10m_.... Use a chave no seu servidor (não no app do cliente). Cada resposta informa o uso do mês nos cabeçalhos X-Uso-Mes e X-Limite-Mes.
GET/buscar?q=…&cidade=…&uf=…
Sugestões enquanto digita
Mínimo de 3 letras. Opcional: lat e lng para puxar os resultados para perto.
curl -H "Authorization: Bearer 10m_SUA_CHAVE" \
"https://10oferta.com/api/10mapas/v1/buscar?q=carlos%20wagner%20169&cidade=Canoinhas&uf=SC"
{
"resultados": [
{ "tipo": "casa", "titulo": "Rua Carlos Wagner, 169", "descricao": "Campo Dagua Verde · Canoinhas/SC",
"rua": "Rua Carlos Wagner", "numero": "169", "bairro": "Campo Dagua Verde",
"cidade": "Canoinhas", "uf": "SC", "cep": "89466-148", "lat": -26.169757, "lng": -50.37819 }
],
"atribuicao": "10mapas · dados © IBGE (CNEFE 2022) e © colaboradores do OpenStreetMap (ODbL)"
}tipo: casa (número exato), rua (ponto no meio da rua) ou lugar (estabelecimento).
GET/geocodificar?rua=…&numero=…&cidade=…&uf=…
Ponto de um endereço
Também aceita bairro e cep. Número e bairro são opcionais.
GET https://10oferta.com/api/10mapas/v1/geocodificar?rua=Rua%20Vidal%20Ramos&numero=1122&cidade=Canoinhas&uf=SC
{ "lat": -26.178022, "lng": -50.394333, "precisao": "numero", "atribuicao": "..." }precisao: numero, rua, cep, bairro ou cidade.
GET/reverso?lat=…&lng=…
Endereço de um ponto
GET https://10oferta.com/api/10mapas/v1/reverso?lat=-26.1766&lng=-50.39
{ "rua": "Rua Frei Menandro Kamps", "numero": "", "bairro": "Centro",
"cidade": "Canoinhas", "uf": "SC", "cep": "89460-054", "atribuicao": "..." }GET/rota?de=lat,lng¶=lat,lng&perfil=moto
Rota
perfil: carro (padrão), moto, bicicleta ou pe. Até 10 paradas no caminho: paradas=lat,lng;lat,lng. O trajeto vem como lista de pontos [lat, lng].
GET https://10oferta.com/api/10mapas/v1/rota?de=-26.1745,-50.3887¶=-26.1812,-50.3951&perfil=moto
{ "distancia_m": 1624, "duracao_s": 119, "perfil": "moto", "trajeto": [[-26.174287,-50.389044], ...], "atribuicao": "..." }GET/cidades
Cidades com endereços completos
Lista as cidades já na base completa do 10mapas (as demais usam a busca geral).
Erros
Sempre no formato { "erro": { "codigo": "...", "mensagem": "..." } }: 401 nao_autorizado, 422 parametro, 404 nao_encontrado, 429 limite ou limite_mensal, 502 rotas_indisponivel.
Quer usar o 10mapas?
Planos por volume de chamadas, com teste gratuito. Fale com a gente e diga quantas buscas e rotas você usa por mês.
suporte@10oferta.com