Envie uma lista de endereços e receba cada um como uma linha - latitude e longitude, o endereço normalizado para uma forma postal completa, e país, estado, cidade, rua, código postal e fuso horário divididos em colunas próprias. Vinte colunas na forma atual, todas medidas a partir de exports reais.
Isso é mais raro do que parece neste catálogo, e é a razão pela qual esta página pode falar de colunas confirmadas e não declaradas.
A referência publicada documenta o lado do pedido - endereços para dentro, em lotes de até 1.000 por requisição - e, invulgarmente, também enumera onze campos de resposta: query, latitude, longitude, country, state, city, borough, street, postal_code, time_zone e street_view.
Temos cinco exports reais que cobrem sete linhas e duas consultas distintas. A forma atual devolve esses onze mais nove que a referência não menciona - address, lat, lon, matched_address, type, class, importance, osm_type e osm_id - vinte colunas no total. Uma execução mais antiga devolveu apenas essas nove. As duas fontes corroboram-se onde se sobrepõem, e o export é a mais larga das duas.
Cada uma das vinte levou um valor real em pelo menos uma linha, e por isso o dicionário de dados abaixo descreve o que cada uma contém em vez de se resguardar. As duas exceções são honestas: borough e street vieram vazias para Central Park, NY, porque um parque não tem número de porta.
Um endereço é toda a entrada. Não há filtros para configurar.
Tanto um endereço completo como um simples monumento funcionam - os exemplos da própria referência são 321 California Ave, Palo Alto, CA 94306 e Central Park, NY, e ambos estão nos exports por trás desta página.
Medido a partir de 5 exports reais que cobrem 7 linhas e 2 consultas distintas. Os nomes estão copiados carácter a carácter da linha de cabeçalho, pela ordem da folha. Os valores de exemplo abaixo são células reais dessas execuções.
37.4270819. Idêntica a latitude; ver a nota abaixo.-122.1439887. Idêntica a longitude.321, South California Avenue, Evergreen Park, Palo Alto, Santa Clara County, California, 94306, United States.house para o endereço, park para o Central Park.place e leisure respetivamente. Leia class e type como um par.0.0001 para a casa, 0.612 para o Central Park.node para a casa, way para o parque.1734450110. Suficientemente estável para juntar por ele.lat.lon.United States.California, New York.Palo Alto, New York.Evergreen Park. Vazia para o Central Park, que não tem essa componente.321 South California Avenue. Vazia para o Central Park, que não tem número de porta.94306. Vale a pena confirmar em elementos de grande área; ver a nota abaixo.America/Los_Angeles, America/New_York. Diretamente utilizável para cálculos de hora local.https://www.google.com/maps?q=&layer=c&cbll=37.4270819,-122.1439887.Todas as colunas acima levaram um valor real nas execuções que temos, e é por isso que esta tabela descreve conteúdos em vez de se resguardar. Duas células estiveram legitimamente em branco - borough e street no parque - e isso é uma propriedade do lugar, não uma falha da consulta. A amostra é pequena e deliberadamente não é expressa como percentagem: 7 linhas em 2 consultas dizem-lhe com fiabilidade que forma tem um export e nada sobre taxas de acerto em volume. Passe primeiro uma fatia do seu próprio ficheiro pelo nível gratuito.
Cada uma saiu da leitura dos exports e não da referência, e é por isso que valem o espaço.
lat e latitude levam o mesmo valor, tal como lon e longitude - em todas as linhas que temos. Nenhuma é mais autoritativa do que a outra; a forma antiga de 9 colunas simplesmente só tem o par curto. Note que ambas são cadeias de texto e não números, portanto converta antes de fazer aritmética ou irá ordenar -122 ao lado de -73 alfabeticamente.
Submeter Central Park, NY devolve coordenadas e um endereço correspondente, mas borough e street vêm vazias, porque não há número de porta a dar. Se o seu pipeline tratar uma rua ausente como consulta falhada, descartará linhas perfeitamente boas. Ramifique consoante haja coordenadas, não consoante todas as partes do endereço estejam preenchidas.
A linha do Central Park veio com postal_code 11025. Os códigos postais do Central Park estão na gama 100xx, portanto esse valor não descreve o parque. Um polígono grande tira as suas partes de endereço de um ponto representativo, e em elementos que abrangem muitos códigos postais o resultado pode cair fora. Confie nas coordenadas; verifique o código postal antes de encaminhar correio ou de juntar por ele.
class e type são a chave e o valor da etiqueta principal do elemento encontrado, osm_type e osm_id apontam para o próprio objeto, e importance é o grau de importância calculado pelo OSM. Isso é genuinamente útil: filtrar por class permite ficar com edifícios e descartar parques, e importance separa um monumento de uma porta - 0.612 contra 0.0001 nas nossas duas linhas.
A geocodificação é canalização - é o que tem de funcionar antes de começar a análise interessante.
Cada linha resolvida traz latitude e longitude, portanto uma folha de clientes passa a ser algo que se pode representar, agrupar e rodear de áreas de influência. Uma requisição leva até 1.000 endereços, o que faz de um ficheiro grande umas quantas chamadas em vez de um problema de limite de taxa.
As colunas já separadas fazem o que as coordenadas sozinhas não conseguem: state, city e postal_code chegam em campos próprios, pelo que atribuir uma conta a um território comercial ou a uma área de serviço passa a ser um join em vez de um exercício de análise de texto.
time_zone volta como nome IANA do género America/Los_Angeles, que é exatamente o que uma biblioteca de datas quer. Isso transforma «que horas são para este cliente» de um palpite baseado no país numa resposta correta que sobrevive à hora de verão.
Sem subscrição, sem mínimo, sem licença por utilizador. As suas primeiras 500 linhas são por nossa conta - depois, paga conforme usa.
Para cada conta nova, uma única vez. Sem cartão de crédito. O suficiente para correr uma fatia real do seu ficheiro de endereços e ver como lida com as linhas problemáticas - as abreviaturas, os códigos postais em falta, os monumentos.
Cerca de 2 $ por 1.000 endereços, uma linha por endereço - exato de orçamentar, porque um endereço que não resolve nada devolve na mesma exatamente uma linha.
Preços por volume, SLAs, workers dedicados e onboarding à medida para equipas que geocodificam um ficheiro grande com regularidade. Diga-nos os seus números e fazemos orçamento.
LIVESCRAPER10 ao finalizar a compra.Um transforma coordenadas de volta em endereços; o outro diz-lhe que negócios estão neles.
O mesmo serviço no sentido contrário - coordenadas para dentro, um endereço legível para fora, com um Plus Code e o condado ao lado. Útil quando os seus dados chegam como sinais de GPS em vez de endereços escritos.
As coordenadas dizem-lhe onde; este diz-lhe o quê - os negócios num local com as suas categorias, avaliações, horários e contactos. O passo natural seguinte assim que uma lista está no mapa.
Uma das questões mais leves do catálogo, e vale a pena dizer porquê em vez de simplesmente afirmá-lo.
Um endereço, as suas coordenadas e o seu fuso horário são factos sobre um local. Nada nestas vinte colunas descreve uma pessoa: não há nome, nem morador, nem contacto. A geografia subjacente vem do OpenStreetMap, um mapa colaborativo público, e é por isso que o export traz os identificadores e etiquetas do próprio OSM.
O que merece reflexão é a sua entrada. Se os endereços que envia são moradas de clientes, essa lista já era dado pessoal antes de nos chegar e continua a sê-lo depois - geocodificá-la acrescenta precisão a um registo sobre uma pessoa. Trate o ficheiro em conformidade. Se precisa de saber quem vive num endereço em vez de onde ele fica, isso é uma categoria diferente e muito mais restrita, coberta pelo Whitepages Addresses com as suas próprias regras de uso permitido.
Do nosso lado: 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 os seus exports apagam-se automaticamente ao fim de 30 dias.
As perguntas que mais ouvimos. Mais alguma coisa? Fale connosco - as respostas são escritas por pessoas, não por bots.
query, latitude, longitude, country, state, city, borough, street, postal_code, time_zone e street_view - e o export acrescenta mais nove: address, lat, lon, matched_address, type, class, importance, osm_type e osm_id. Cada uma das vinte levou um valor real nas execuções por trás desta página.address, lat, lon, matched_address, type, class, importance, osm_type e osm_id; a atual devolve essas mais as onze que a referência documenta. Escreva o seu importador contra as nove e trate o resto como presente-se-existir, em vez de assumir um cabeçalho fixo.lon e longitude. O par curto aparece em ambas as formas de export e o longo só na mais larga, portanto se quiser um único caminho de código, leia lat e lon. Ambos chegam como texto, converta-os antes de fazer aritmética ou ordenar.Central Park, NY devolve coordenadas, um endereço correspondente, uma cidade, um estado e um fuso horário, mas nem número de porta nem bairro - um parque não os tem. Trate uma linha como bem-sucedida quando tem coordenadas, não quando todas as partes do endereço estão preenchidas.postal_code 11025, que não é um código postal do Central Park - um polígono grande tira as suas partes de endereço de um ponto representativo, e num elemento que abrange muitos códigos postais esse ponto pode cair fora. As coordenadas são a parte fiável; verifique o código postal antes de encaminhar correio por ele.Cole os seus endereços e obtenha coordenadas, partes de endereço já separadas e um fuso horário para cada um. As suas primeiras 500 linhas são grátis - o suficiente para ver como lida com as linhas problemáticas dos seus próprios dados.
A geocodificação é o passo que tem de funcionar antes de começar qualquer análise de localização: uma coluna de endereços escritos por pessoas transforma-se num par de coordenadas que se pode representar, medir e juntar. Este serviço fá-lo em lote. Envie uma lista de endereços - um endereço completo como 321 California Ave, Palo Alto, CA 94306, ou um simples monumento como Central Park, NY, ambos exemplos da própria referência publicada - e cada um volta como uma única linha, pelo que o ficheiro de entrada e o de saída correspondem exatamente.
O export atual traz vinte colunas, e esta página é invulgar no catálogo por conseguir descrevê-las todas a partir de medição e não de um mero cabeçalho. Onze são publicadas pela referência: a consulta submetida devolvida, latitude e longitude, país, estado, cidade, bairro, rua, código postal, um fuso horário IANA e um link do Google Street View já construído a partir das coordenadas. O export acrescenta mais nove que a referência não menciona: o endereço tal como submetido, um par curto lat/lon, um endereço totalmente normalizado separado por vírgulas, e cinco campos vindos diretamente do OpenStreetMap - a classe e o tipo da etiqueta principal do elemento, o tipo e o id do objeto no OSM, e o grau de importância calculado pelo OpenStreetMap. Ao longo de cinco exports reais que cobrem sete linhas, cada uma das vinte levou um valor real pelo menos uma vez.
Quatro pormenores importam a quem escrever o importador, todos observados e não assumidos. As coordenadas chegam a dobrar - lat e latitude são o mesmo valor, tal como lon e longitude - e ambas são texto em vez de números, exigindo conversão antes de aritmética ou ordenação. Um monumento não é um endereço: a linha do Central Park devolveu coordenadas, uma cidade e um fuso horário mas nem rua nem bairro, porque um parque não tem nenhum dos dois; um pipeline deve portanto tratar a presença de coordenadas como sucesso em vez de exigir todas as partes. Os códigos postais merecem verificação em elementos grandes: essa mesma linha do parque devolveu um código fora da gama 100xx que realmente cobre o Central Park, que é o que acontece quando um polígono que abrange muitos códigos reporta o de um ponto representativo. E os campos do OpenStreetMap são genuinamente úteis e não decorativos: filtrar por class separa edifícios de parques, e importance separa um monumento de uma porta, 0,612 contra 0,0001 nas nossas duas linhas.
No plano legal, este é dos serviços mais leves do catálogo. Um endereço, as suas coordenadas e o seu fuso horário são factos sobre um lugar; nenhuma das vinte colunas descreve uma pessoa, e a geografia subjacente vem do OpenStreetMap, um mapa colaborativo público. O que merece reflexão é a entrada: se os endereços que envia são moradas de clientes, essa lista já era dado pessoal antes de nos chegar e continua a sê-lo, devendo ser tratada em conformidade. 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.