Mapas
Encontre endereços, resolva coordenadas e calcule rotas
Uma busca com lista de resultados, geocodificação nos dois sentidos e rotas com paradas. Vários provedores de mapas trabalham por trás da API, e você paga por solicitação bem-sucedida.
Somente para empresas e profissionais autônomos
- Busca de endereço 1,00 EUR por 1.000 solicitações bem-sucedidas
- Geocodificação 1,00 EUR por 1.000 solicitações bem-sucedidas
- Rota 2,00 EUR por 1.000 solicitações bem-sucedidas
/v1/maps/search?q=Alexanderplatz%201%20Berlin&limit=1
curl "https://api.flowdata.one/v1/maps/search?q=Alexanderplatz%201%20Berlin&limit=1" \
-H "Authorization: Bearer fd_SUA_CHAVE"
{
"success": true,
"addresses": [
{
"lat": 52.5219,
"lng": 13.4132,
"full_address": "Alexanderplatz 1, 10178 Berlin, Alemanha",
"address_name": "Alexanderplatz 1",
"address_number": "1",
"street_name": "Alexanderplatz",
"postcode_name": "10178",
"locality_name": "Mitte",
"place_name": "Berlin",
"region_name": "Berlin",
"region_code": "BE",
"country_name": "Alemanha",
"country_code": "DE"
}
],
"attribution": "NOTICE: © 2026 Creative Skyline and its suppliers. All rights reserved. Use of this data is subject to the Creative Skyline Terms of Service (https://creativeskyline.de/agb). This response and the information it contains may not be retained."
}
Campos e estrutura como na API, os valores são exemplos.
Endpoints
Cada resposta traz success, o resultado e uma nota em attribution. Use language para escolher o idioma dos resultados.
| GET | /v1/maps/search |
Busca de endereços e lugares com q, opcionalmente limit (1 a 10), country, proximity e types. |
|---|---|---|
| GET | /v1/maps/geocode |
Endereço para coordenadas com address, coordenadas para endereço com lng e lat. |
| GET | /v1/maps/directions |
Rota com origin, destination, waypoints e profile: driving, driving-traffic, walking ou cycling. |
As três ferramentas
-
Busca de endereços
Até 10 resultados com
full_address, rua, número, CEP, cidade, região e país. Refine comcountryeproximity. -
Geocodificação
Uma chamada, duas direções:
addressretorna coordenadas,lngelatretornam um endereço. -
Rotas
Distância e duração entre dois pontos, opcionalmente com paradas (
waypoints, separadas por|) e rotas alternativas.
Provedores e armazenamento
-
Vários provedores
Dependendo da consulta e da disponibilidade, responde Mapbox, Google, MapTiler, Nominatim ou Radar. A escolha é do FlowData.
-
Armazenamento de resultados
Guardamos os endereços encontrados e respondemos solicitações iguais a partir deles. Uma resposta do armazenamento é cobrada como qualquer outra.
Capturas de tela mostram a interface do FlowData em alemão, com os dados de exemplo de uma empresa fictícia.
O que esperar
Termos de busca e coordenadas vão para o provedor de mapas que responde. Guardamos os endereços encontrados no nosso armazenamento de resultados.
Uma busca sem resultados é grátis, assim como solicitações que terminam em erro.
A API entrega dados, não blocos de mapa. Para exibir um mapa, você integra uma biblioteca de mapas por conta própria.
Os provedores de mapas têm termos de uso próprios. A resposta os indica no campo
attribution, e segundo essa nota os resultados não podem ser armazenados permanentemente.
Respostas via Nominatim contêm dados do OpenStreetMap: © colaboradores do OpenStreetMap, disponíveis sob a Open Database License (ODbL). Licença do OpenStreetMap
Perguntas frequentes
full_address) e suas partes, para você montar como quiser no seu formulário ou banco de dados.
driving-traffic. Também estão disponíveis driving, walking e cycling.