Obtenha geocodificação em nível corporativo gratuitamente com a API Positionstack (REVIEW)

Você não precisa ser o Google Maps para obter valor com a geocodificação. E, graças ao Positionstack, você também não precisa do orçamento de tecnologia do Big G. Hoje, analisamos a API robusta do Positionstack, que visa tornar a geocodificação avançada e reversa em nível empresarial altamente acessível e utilizável.

Positionstack 101

Então, por que você deveria ler uma revisão de mais de 2.000 palavras Positionstacke o que você ganha? A resposta parece fofa, mas é precisa: a mundo inteiro.

Considere por um momento quantos lugares existem no mapa do mundo. Agora, multiplique esse número em sua cabeça por cada pedaço de metadado que sua empresa precisa conhecer sobre esses lugares. É isso que o Positionstack oferece e mais.

Vejamos algumas estatísticas rápidas sobre o Positionstack:

• Bilhões reais de solicitações de pesquisa de geocodificação processadas a cada hora, todos os dias; com 100% de tempo de atividade e tempos de resposta <100ms
• Infraestrutura altamente escalável baseada em nuvem
• Dados em tempo real de todos os países do mundo, compilados em um conjunto de dados cavernoso que é atualizado a cada poucas horas
  instagram viewer
• Planos de assinatura generosamente distribuídos e com preços competitivos; além de uma cota mensal incomparável de 10.000 solicitações para usuários gratuitos
• Suporte de integração para todas as principais linguagens de programação
• Documentação abrangente e de fácil leitura, completa com trechos de código
• Uma equipe de satisfação de clientes de classe mundial, com experiência em atender clientes como Zendesk, Slack, LinkedIn, Lyft, Apple e Amazon

O Positionstack certamente tem seu pedigree sob controle, mas, caso você não esteja convencido de alguns pontos, vamos aprofundar como é realmente usar a API.

Guia de início rápido em três etapas do Positionstack

Se você gastar algum tempo no site deles, verá que o Positionstack realmente enfatiza a facilidade de uso como principal ponto de venda da API. Durante o processo de inscrição, você verá imediatamente que isso é verdade. De fato, a primeira coisa que você vê depois de digitar as credenciais da sua conta é um roteiro rápido do que é necessário para começar a operar com o Positionstack em três etapas fáceis. Vamos dar uma olhada:

1. Defina sua chave de acesso à API - Por padrão, você recebeu uma chave de acesso pronta para sair da caixa. No entanto, você pode redefinir isso facilmente, conforme necessário.
2. Escolha pontos de extremidade da API - Abordaremos os pontos de extremidade da API com mais profundidade na próxima seção, mas, por enquanto, apenas entenda que esta etapa se refere à configuração de que tipo de dados é retornado quando seu aplicativo faz uma solicitação ao Positionstack. É aqui que você vê primeiro o URL base, que é o local em que você direciona suas solicitações, mas ele também aparece na documentação. Por fim, vemos um exemplo de solicitação de API, que consiste em apenas algumas linhas fáceis de código.
3. Integração de aplicativos - A última etapa refere-se à integração final da API do Positionstack em seu aplicativo. Há uma quantidade razoável de informações sobre esse processo e a maioria é abordada na documentação. O importante aqui é: a equipe de suporte do Positionstack está à sua disposição e oferecerá a ajuda necessária para configurar e integrar a API deles ao seu aplicativo.

Muito fácil né? As APIs podem parecer intimidantes para as pessoas sem amplo conhecimento de TI a princípio. Mas logo de cara, o Positionstack conforta você com o conhecimento de que não só é fácil, como também o ajuda com uma documentação incrível de seu design inteligente. Ajuda a que eles também tenham uma equipe apaixonada de especialistas, prontos para ajudá-lo.

Seu painel Positionstack

Dobrando seu principal valor de facilidade de uso, o Positionstack oferece um Painel simplificado e organizado, a partir do qual você pode acessar tudo o que precisa saber sobre sua API. Vamos dar uma olhada nas opções da barra lateral:

• painel de controle - Aqui você encontra notificações (geralmente alertando-o à medida que ultrapassa certos limites de uso) e, em seguida, links para o Guia de início rápido em três etapas e a respectiva página de documentação. Também há uma visão geral da sua chave de API, sua assinatura atual, detalhes da conta e método de pagamento.
• Upgrade / Assinatura - Você pode alterar sua assinatura em uma dessas duas opções. Faça o upgrade a qualquer momento. No entanto, se você desejar alternar entre um plano mensal ou anual em qualquer direção, precisará primeiro fazer o downgrade para uma conta gratuita e escolher a opção desejada. O suporte do Positionstack está disposto a ajudá-lo se você precisar de ajuda para fazer isso.
• Conta / Pagamento - Estes são auto-explicativos; qualquer uma das guias permitirá que você atualize suas credenciais a qualquer momento. Devemos dizer que agradecemos que eles não enterrem esses controles básicos em uma interface chamativa e super projetada. WYSIWYG.
• Uso da API - Provavelmente a guia que você revisitará com mais frequência. Aqui, você pode descobrir quanto da sua cota de solicitações mensais consumiu até agora. Também há uma seção útil que mostra suas estatísticas de uso ao longo do tempo, para que você possa ajustar sua estratégia de acordo.

Documentação da API

Agora chegamos ao coração e à alma da oferta do Positionstack: o Documentação da API. Considere esta página como seu manual do usuário, que detalha cada ponto de extremidade da API, seus parâmetros e que tipo de informação eles retornarão.

Esta página está dividida em cinco seções diferentes. Examinaremos cada um deles, gastando algum tempo e verborragia para fornecer algum contexto para você entender melhor o que encontrará.

Começando

Aqui, você encontrará funções básicas que se aplicam a todas as solicitações feitas com o Positionstack. Esses são:

• Chave API - Sua chave de API é como um passaporte digital que você usará para acessar o conjunto de dados do Positionstack. Sem ele, a API é inútil para você. Se você acredita que foi comprometida, pode facilmente girar sua chave antiga para uma nova.
• Criptografia - A criptografia SSL de 256 bits é usada em toda a Internet e é o padrão de segurança do setor por um bom motivo. Embora você precise de um plano básico ou melhor para criptografar as comunicações do seu aplicativo com os servidores do Positionstack, vale a pena investir por conta própria. Para evocar a criptografia, basta alterar HTTP para HTTPS no URL base da API. Simples!
• Retornos de chamada JSON - Não entraremos em muitos detalhes técnicos de como isso funciona, mas se suas solicitações de API estiverem bloqueadas por políticas da mesma origem, você usará retornos de chamada JSON para afetar uma solução alternativa. Essencialmente, você solicita dados de um script externo, que não se atola a problemas entre domínios.
• Erros de API - Como em qualquer coisa, às vezes suas solicitações de API apresentam erros. O Positionstack entende isso e incorporou ao aplicativo uma funcionalidade de relatório de erros para ajudá-lo a identificar o que deu errado. As falhas de solicitação da API retornarão automaticamente um objeto de erro no formato JSON, além de subobjetos de código, mensagem e contexto para fornecer contexto para o erro.

Pontos finais da API

Esta seção documenta a funcionalidade de carne e batatas do Positionstack, ou seja, geocodificação direta e reversa. Se você não tem 100% de certeza da diferença, pense no geocodificação como uma via de mão dupla onde você pode traduzir locais e endereços escritos em inglês simples para dados de localização, como coordenadas e endereços IP, e Vice e versa.

Então, você usaria a geocodificação direta para converter a localização da Torre Eiffel em coordenadas. Da mesma forma, você pode descobrir o endereço associado a um endereço IP usando geocodificação reversa. Muito simples, afinal!

Encaminhar / reverter solicitações de geocodificação

Para fazer uma solicitação básica para qualquer tipo de geocodificação, é necessário anexar o ponto de extremidade apropriado (/forward ou /reverse) para o URL base da API. Em seguida, você fornecerá sua chave de acesso e fará uma inquerir usando um endereço de localização em inglês ou seus dados de localização correspondentes - e pronto! Será algo parecido com isto:

https://api.positionstack.com/v1/forward? access_key = YOUR_ACCESS_KEY & query = 1600 Pennsylvania Ave NW, Washington DC. 

ou

https://api.positionstack.com/v1/reverse? access_key = YOUR_ACCESS_KEY & query = 40.7638435, -73.9729691. 

Obviamente, o conjunto de dados do Positionstack contém muito, muito mais do que apenas endereços e coordenadas. Você pode analisar essas outras categorizações usando vários parâmetros. Aqui está um exemplo do que geocodificação direta pedido, consultando a Casa Branca, parece com:

{"data": {"results": [{"latitude": 38.897675, "longitude": -77.036547, "label": "1600 Pennsylvania Avenue NW, Washington, DC, EUA", "nome": "1600 Pennsylvania Avenue NW "," tipo ":" endereço "," número ":" 1600 "," rua ":" Pennsylvania Avenue NW "," postal_code ":" 20500 "," confiança ": 1," região ":" Distrito of Columbia "," region_code ":" DC "," Administrative_area ": null," neighborhood ":" White House Grounds "," country ":" Estados Unidos "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Curiosamente, se você fizesse uma geocodificação reversa solicitação usando as coordenadas aproximadas da Casa Branca, os resultados retornados seriam quase idênticos, exceto que você também veria a diferença em distância entre suas coordenadas e as coordenadas oficiais da Casa Branca, conforme elas aparecem no conjunto de dados do Positionstack.

A razão para essa semelhança é que ambos os terminais utilizam a mesma matriz de parâmetros GET e, portanto, são capazes de retornar (quase) os mesmos objetos de resposta. Isso significa que, independentemente dos dados iniciais que você precisa buscar, você pode obter um complemento completo dos dados de localização. (É possível restringir esses resultados usando as APIs Campos parâmetro, mas abordaremos isso mais tarde.)

Nota: a página de documentação do Positionstack detalha cada parâmetro e objeto de resposta, portanto, verifique!

Solicitações em lote

O último cabeçalho principal nesta configuração de documentação trata de solicitações em lote. Tudo o que você precisa fazer é chamar o lote parâmetro e aninhe vários inquerir instâncias (junto com os parâmetros desejados) abaixo em uma única solicitação, e a API do Positionstack cuida do resto. É simples, e fica assim:

{"batch": [{"query": "Main Street", "country": "US", "region": "Minnesota"}, {"query": "Main Street", "país": "EUA", "região": "Illinois"}, {"consulta": "Rua principal", "país": "EUA", "região": "Missouri"} ] }

Dados avançados

Além dos parâmetros básicos de localização, você pode personalizar ainda mais suas solicitações de API para retornar mais dados avançados. Esses incluem:

• Mapas incorporáveis - Retorna um objeto map_url vinculado ao seu resultado de geocodificação, que você pode usar para criar uma representação visual atraente do mapa no seu site ou aplicativo.
• Módulo do país - Ao contrário de outros parâmetros que retornam até alguns objetos de resposta, country_module retorna uma incrível variedade de dados sobre o país consultado. Também não são apenas coordenadas e endereços; é a capital, bandeira, nome oficial, status de país sem litoral (ou não), moedas usadas, idiomas falados, códigos de chamadas e muito mais.
• Módulo Sun - Humoristicamente, a documentação do Positionstack descreve isso como dados "astrológicos". Você não receberá seu horóscopo com esse parâmetro, mas verá dados sobre quando o sol nasce e se põe, de acordo com a cronologia astronômica, civil e náutica.
• Módulo de fuso horário - Anexar timezone_module para retornar o deslocamento GMT de um local em segundos ou como uma sequência de idioma natural.
• Módulo da caixa delimitadora - Se um único par de coordenadas x / y não for adequado para sua tarefa, tente uma caixa delimitadora, que encerra uma área com valores mínimos e máximos para longitude e latitude.

Opções adicionais

A API Positionstack tem uma tonelada de dados para você, mas, felizmente, fornece a você ferramentas adicionais para gerenciar esse acervo de informações.

• Especificar campos de resposta - Abordamos detalhadamente a quantidade de dados que o Positionstack pode retornar, mas lembre-se de que todos esses dados têm um custo. Se você deseja limitar seus pedidos mensais, pode fazer isso com o Campos Anexar fields = results.flag, por exemplo, fará com que a API produza apenas a bandeira do seu país consultado. Você pode invocar Campos quantas vezes você precisar para obter o conjunto de dados específico necessário.
• Especificar formato de saída - Os assinantes gratuitos são limitados ao formato JSON para os resultados de geocodificação retornados. Clientes pagantes, no entanto, podem acrescentar resultado em suas solicitações para especificar JSON, XML ou GeoJSON conforme necessário.

Exemplos de código

Quando o Positionstack diz que está aqui para ajudá-lo, eles querem dizer isso. Já vimos a profundidade da documentação deles, mas eles ainda são úteis exemplos de código em todos os idiomas que sua API suporta. Não vamos copiar / colar esse código aqui, mas, para referência rápida, esses idiomas são:

• Pitão
• Nodejs
• jQuery
• Vai
• Rubi

Prova e desempenho

Nesse ponto, deve ficar claro que o Positionstack é capaz de fazer bastante. Mas, Quão bem faz essas coisas?

Primeiro, vamos considerar algum contexto. O Positionstack é um dos mais de 20 microsserviços de API no ecossistema baseado em nuvem da Apilayer. Juntas, essas APIs atendem a mais de um milhão de clientes B2B, desde startups até empresas. Alguns de seus clientes mais notáveis ​​incluem Amazon, Apple, Slack, LinkedIn e muitos outros nomes familiares. Claramente, eles têm uma infraestrutura robusta para lidar com essa escala de demanda.

Por seus próprios méritos, o Positionstack faz jus ao seu pedigree, com um incrível tempo de atividade de 100% ao longo de 2020 no momento da redação. Isso é ainda mais impressionante quando você considera a API rotineiramente processa mais de um bilhão de pesquisas de geocódigo por dia por cliente de baleia, sem mencionar a variedade estonteante de solicitações simultâneas provenientes de seus estábulos de clientes de pequenas e médias empresas. Além disso, essas solicitações normalmente recebem respostas entre 10 e 100 ms.

Em nosso livro, isso é uma maravilha tecnológica, especialmente considerando o preço agressivo dessa oferta de SaaS.

E não é apenas a força bruta que torna o Positionstack tão atraente. Seu conjunto de dados é verdadeiramente sofisticado, proveniente de nomes confiáveis ​​como Nominatim, GeoNames, Pelias e OpenStreetMap. O Positionstack verifica, filtra e recombina essa riqueza de dados várias vezes ao dia, atualizando regularmente através de algoritmos inteligentes que garantem que você sempre tenha dados de localização altamente precisos, em qualquer lugar do mundo e em tempo real Tempo.

Detestamos estragar nosso veredicto final, mas se você está procurando uma solução robusta e escalável de geocodificação, o currículo do Positionstack exige uma análise mais detalhada.

Preços

A Apilayer se propôs a fornecer uma alternativa acessível ao software de geocodificação no nível corporativo altamente caro e, para esse fim, eles foram bem-sucedidos.

Positionstack vem em cinco precificação e suporta faturamento mensal ou assinaturas anuais com um desconto de 20%. Essas camadas são:

• Livre - Classificado para uso pessoal, você ainda está obtendo uma boa milhagem com 25.000 solicitações mensais para geocodificação direta e reversa, produzidas no formato JSON. Você não possui muitos recursos avançados ou suporte ao cliente, mas já mostramos qual é um recurso valioso na página de documentação deles. Esse nível é gratuito e sem obrigação - você nem precisa fornecer detalhes do cartão de crédito para começar.
• Basic - O pacote comercial básico. Os assinantes básicos quadruplicam sua cota mensal para 100.000 solicitações de geocodificação, além de obter acesso a avançadas recursos como criptografia HTTPS, várias opções de saída (JSON, XML, GeoJSON), mapas incorporáveis, vários idiomas, e mais. Obtenha uma licença comercial do Positionstack por apenas US $ 9,99 por mês.
• Profissional - A oferta mais popular do Positionstack, a camada Professional oferece um aumento de dez vezes nas solicitações de geocodificação - até 1.000.000 por mês. Todos os presentes da camada Básica estão presentes e, em seguida, alguns, incluindo solicitações em lote para aplicativos pesados. Esse nível chega a US $ 49,99 por mês.
• O negócio - Adotando o desempenho em escala corporativa, a camada de Negócios aumenta a cota mensal para 3.000.000 de solicitações. Mais uma vez, todos os recursos avançados estão totalmente disponíveis, apoiados pela apaixonada equipe de suporte ao cliente da Positionstack para ajudá-lo a tirar o máximo proveito deles. US $ 99,99 por mês.
• Empreendimento - Esse é o nível em que as ofertas padrão saem pela janela e o cliente é o rei. Você tem necessidades precisas que exigem soluções personalizadas, e o Positionstack está pronto para atingir seus objetivos. Você determina suas solicitações de volume mensal, mesmo (especialmente) se elas são variáveis. Precisa de mais potência da API? Entre em contato com o suporte para soluções personalizadas. Entre em contato com Positionstack para uma cotação.

Veredito

O Positionstack faz exatamente o que se propôs a fazer: reduzir a geocodificação no nível da empresa dos pontos de preço fora do orçamento para a maioria das pequenas e médias empresas, sem sacrificar o desempenho. Sua API é bem documentada e fácil de usar, mas apresenta integração robusta em todas as principais linguagens de programação para obter o máximo de utilidade. O número de solicitações que o Positionstack manipula rotineiramente é impressionante, enquanto o conjunto de dados é mantido de maneira inteligente para alcance verdadeiramente global na geocodificação em tempo real. Se você está no mercado para esse tipo de produto, não durma no Positionstack.

Que tipo de integração você planejou? Como você utilizará a geocodificação nos seus negócios? Você tem perguntas ou comentários sobre o Positionstack? Deixe-nos uma nota nos comentários abaixo.