Ferramentas abertas

Ferramentas

Três calculadoras que respondem a uma pergunta a partir de um URL e devolvem a mesma resposta como widget e como JSON. Sem conta, sem chave, sem custo, e a licença permite republicar o que sai.

As três ferramentas

Ordenadas pela matéria da resposta. A primeira reproduz o que um armador publicou, a segunda tira de um horário apresentado uma de cinco componentes, e a terceira calcula todos os números que mostra.

  1. Que barcos fazem esta rota, quem os opera, quanto tempo demoram e quanto cobra o armador.

    Medido. Cada linha é uma das 2709 travessias publicadas por 120 armadores, com a partida, a duração, o navio e a tarifa tal como apresentados. Um instantâneo datado, não a disponibilidade em direto.

  2. Quanto tempo demora realmente uma viagem depois de contar o percurso até à estação e a espera no local.

    Apresentado numa das cinco componentes e derivado nas restantes. O tempo dentro do veículo é apresentado em 545 corredores e derivado em todo o resto, e chegar ao terminal, esperar lá e as mesmas duas coisas do outro lado são sempre derivadas. Uma linha é rotulada pela componente a bordo e nunca pelo total.

  3. Quanto custa uma viagem à atmosfera, em cada meio capaz de a fazer.

    Derivado de ponta a ponta. Cada número é um dos 6 fatores publicados multiplicado por uma distância obtida a partir de dois pares de coordenadas. Onde um meio serve o corredor, a distância é a do troço. Onde não serve, o meio é modelado sobre a distância ortodrómica, não se afirma qualquer duração e a barra é desenhada oca.

Em que assenta cada resposta

As mesmas três palavras que os conjuntos de dados usam, porque uma ferramenta nunca vale mais do que as linhas que tem por baixo.

Medido
O operador publicou este valor e nós anotámo-lo. Uma tarifa, uma partida, uma duração de travessia.
Apresentado
O que um operador diz que o serviço vai fazer. Um plano, não confrontado com nada do que realmente circulou.
Derivado
Calculado a partir de outros valores. Uma distância entre coordenadas, um valor em gramas publicado aplicado a essa distância, uma margem para chegar a uma estação.

A calculadora de carbono assinala um meio modelado na própria barra e na resposta da API, e a calculadora porta a porta traz por componente uma linha de proveniência com o dia para o qual o operador apresentou o horário.

Três superfícies, uma resposta

Cada ferramenta faz as três coisas. É isso que as torna dignas de uma ligação em vez de uma única visita.

Uma ligação permanente construída no servidor
O formulário é um GET simples, por isso submetê-lo é navegar e a barra de endereço guarda o estado. Não é preciso qualquer script para ver uma resposta, o que também significa que uma ligação para uma resposta continua a funcionar quando é colada num artigo, num email ou num rastreador.
Um widget para colocar na sua própria página
Os mesmos parâmetros sobre uma rota sem a moldura do sítio. A atribuição e a ligação de regresso estão dentro do quadro em vez de serem pedidas ao editor, e cada página de ferramenta imprime o excerto correspondente ao estado que está a mostrar.
Uma API JSON pública
Aberto sem chave e sem registo. Uma forma de resposta versionada, a licença no corpo e num cabeçalho Link, leitura permitida a partir de outros domínios, e o limite de pedidos devolvido nos cabeçalhos de cada resposta.

O limite é de 60 pedidos por minuto por endereço, em cada instância, mantido em memória. Trava um script preso num ciclo.

Usar as respostas

O que sai destas ferramentas está sob CC BY 4.0, a mesma licença dos conjuntos de dados que estão por baixo.

Republique um número, redesenhe-o, ponha o widget num artigo comercial, construa um produto sobre a API. Mencione a Orlero e ligue de volta. É essa a licença inteira.

Uma resposta só está tão atual quanto o instantâneo que a sustenta, por isso cite a data que a ferramenta mostra ao lado do número e não o dia em que a leu.

https://creativecommons.org/licenses/by/4.0/

Planear com o Ori

Ori, o planeador de viagens

Pergunte algo assim