Menu

Documentação

API de Mapas

Busque endereços e lugares, transforme endereços em coordenadas e calcule rotas entre pontos, com uma requisição e uma chave.

Busca
https://api.flowdata.one/v1/maps/search
Geocodificação
https://api.flowdata.one/v1/maps/geocode
Rotas
https://api.flowdata.one/v1/maps/directions

Arquivo OpenAPI desta área

Início rápido

Chave FlowData
Esta API faz parte da FlowData e usa chaves próprias (fd_...), que você cria no dashboard em Chaves de API. Chaves FlowSuite (pk_..., at_...) continuam funcionando, mas recomendamos uma chave FlowData.
Fontes de dados
Os resultados vêm de serviços de mapas: Mapbox, Google, MapTiler e Nominatim. Para responder, sua requisição é enviada a um desses provedores. Dados do Nominatim: © colaboradores do OpenStreetMap, ODbL.

Visão geral

A API de Mapas oferece três funções:

  • Busca: encontrar endereços e lugares no mundo todo
  • Geocodificação: transformar endereços em coordenadas e coordenadas em endereços
  • Rotas: calcular rotas entre dois ou mais pontos

Toda resposta bem-sucedida contém o campo attribution com os termos de uso dos dados.

Geocodificação

Direta e reversa
Informe address (endereço para coordenadas) ou lng e lat (coordenadas para endereço).
GET
/v1/maps/geocode

Resolver endereço ou coordenadas

Transforma um endereço em coordenadas e dados completos de endereço, ou coordenadas de volta em endereço. Somente uma resposta bem-sucedida é cobrada; 404 sem resultado é grátis.

Bearer fd_… 1,00 EUR por 1.000 requisições bem-sucedidas

Parâmetros de consulta

Nome Tipo Descrição
address string Endereço para a busca direta
lng number Longitude para a busca reversa, junto com lat
lat number Latitude para a busca reversa, junto com lng
country string Filtro de país, ISO 3166-1 alpha-2
language string Idioma dos resultados, padrão de
curl -X GET "https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin" \
  -H "Authorization: Bearer fd_SUA_CHAVE" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_SUA_CHAVE')
    ->get('https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin',
    headers=headers,
)

data = response.json()
{
    "success": true,
    "address": {
        "full_address": "Friedrichstraße 43, 10117 Berlin, Deutschland",
        "lat": 52.5094,
        "lng": 13.3889,
        "place_name": "Berlin",
        "postcode_name": "10117",
        "country_name": "Deutschland",
        "country_code": "DE"
    },
    "attribution": "NOTICE: © 2026 FlowSuite and its suppliers. All rights reserved. Use of this data is subject to the Terms of Service (https://creativeskyline.de/agb). This response and the information it contains may not be retained."
}

Rotas

GET
/v1/maps/directions

Calcular rota

Calcula uma rota entre dois ou mais pontos, com distância, duração e geometria. Somente uma resposta bem-sucedida é cobrada; 404 sem rota é grátis.

Bearer fd_… 2,00 EUR por 1.000 requisições bem-sucedidas

Parâmetros de consulta

Nome Tipo Descrição
origin string
Obrigatório
Ponto de partida como lng,lat, por exemplo 13.4050,52.5200
destination string
Obrigatório
Destino como lng,lat
profile string driving, driving-traffic, walking ou cycling, padrão driving-traffic
waypoints string Paradas como lng,lat, separadas por |
language string Idioma das instruções, padrão de
curl -X GET "https://api.flowdata.one/v1/maps/directions?origin=13.4050%2C52.5200&destination=13.3777%2C52.5163" \
  -H "Authorization: Bearer fd_SUA_CHAVE" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_SUA_CHAVE')
    ->get('https://api.flowdata.one/v1/maps/directions?origin=13.4050%2C52.5200&destination=13.3777%2C52.5163');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/maps/directions?origin=13.4050%2C52.5200&destination=13.3777%2C52.5163', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/maps/directions?origin=13.4050%2C52.5200&destination=13.3777%2C52.5163',
    headers=headers,
)

data = response.json()
{
    "success": true,
    "routes": [
        {
            "distance": 3120.4,
            "duration": 540.2,
            "legs": [
                {
                    "distance": 3120.4,
                    "duration": 540.2
                }
            ]
        }
    ],
    "attribution": "NOTICE: © 2026 FlowSuite and its suppliers. All rights reserved. Use of this data is subject to the Terms of Service (https://creativeskyline.de/agb). This response and the information it contains may not be retained."
}

Uma chave basta para começar.

Crie uma chave e chame a API. As informações do cliente são gratuitas; o restante é cobrado por solicitação bem-sucedida.

Criar chave de API Documentação

O FlowData é destinado exclusivamente a empresas e profissionais autônomos.