Geocodificação inversa - converter coordenadas em endereços em escala
A geocodificação inversa é o passo que torna legíveis os dados de coordenadas. Localizadores GPS, formulários móveis, fotos e sensores registam todos apenas latitude e longitude; transformar uma coluna de decimais numa rua, numa cidade e num código postal é o que permite agrupar esses dados, reportá-los e fazê-los compreender por alguém sem um mapa aberto ao lado. Este serviço fá-lo em lote: envie pares de coordenadas - separados por vírgula ou por espaço, ambos documentados - e cada um volta como uma única linha.
O export atual traz dezanove colunas. Onze são publicadas pela referência: a consulta submetida devolvida, o endereço mais próximo como uma única cadeia separada por vírgulas, cidade, código de país de duas letras, condado, um link do Google Street View pronto, um Plus Code, código postal, estado, rua e um fuso horário IANA. O export acrescenta mais oito que a referência não menciona: um par numérico lat/lon que devolve a sua entrada, a classe e o tipo do OpenStreetMap do objeto encontrado, o seu tipo e id de objeto OSM, e um par duplicado latitude/longitude. Ao longo de cinco exports reais que cobrem oito linhas, cada uma das dezanove levou um valor real.
O mais importante a compreender é o que significa «mais próximo». A geocodificação inversa não reporta o endereço do seu ponto; encontra o objeto cartografado mais próximo e reporta o endereço desse objeto. Normalmente esse objeto é um edifício. Às vezes não: uma das duas coordenadas por trás desta página, em Hoboken, devolveu um endereço completo e bem formado cujo type era bench e cujo class era amenity. O ponto estava mais próximo de um banco de jardim, portanto a linha descreve um banco. Nada nas colunas de endereço por si só o revelaria, e é por isso que class e type são os primeiros campos a ler depois do endereço, e por isso que quem associa pontos a instalações deve filtrar por eles. Outros três pormenores importam a quem escrever o importador, todos observados e não assumidos. Aqui as coordenadas chegam como números JSON, ao passo que o serviço direto de Geocodificação devolve esses mesmos campos como texto - uma diferença que surgirá exatamente uma vez, em produção, numa ordenação. Há duas formas de export, uma antiga de oito colunas e a atual de dezanove, portanto programe contra as oito e trate o resto como opcional. E os nomes das colunas diferem do serviço direto em dois pontos: este devolve photo e country_code onde a Geocodificação devolve street_view e country, contendo este último o nome completo do país em vez de um código de duas letras.
No plano legal, este é dos serviços mais leves do catálogo: uma coordenada, o seu endereço mais próximo e o seu fuso horário são factos sobre um lugar, e nenhuma das dezanove colunas descreve uma pessoa. A geografia subjacente vem do OpenStreetMap, um mapa colaborativo público. A entrada, porém, merece mais reflexão do que a saída. Uma lista de coordenadas recolhida de telemóveis, veículos ou wearables é um registo de onde pessoas ou os seus bens estiveram - dado pessoal na maioria das jurisdições antes de nos chegar - e resolvê-la para endereços torna-a mais legível em vez de menos sensível, pelo que deve obedecer ao mesmo critério dos dados de localização de onde veio. Apenas fontes publicamente disponíveis, nada por trás de um início de sessão, sem rastreadores de terceiros na camada de dados, e exports que se apagam ao fim de 30 dias. As suas primeiras 500 linhas são grátis e não pedem cartão.