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

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

Positionstack 101

Então, por que você deveria se preocupar em ler uma revisão de mais de 2.000 palavras no Positionstack , e o que você tem a ganhar? A resposta parece bonita, mas é precisa: o mundo inteiro .

Considere por um momento quantos lugares existem no mapa mundial. Agora, multiplique esse número em sua cabeça por cada pedaço de metadados que sua empresa precisa saber sobre esses lugares. Isso é o que o Positionstack oferece e muito 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 <100ms = "" response = "">
• Infraestrutura altamente escalonável baseada em nuvem
• Dados em tempo real sobre todos os países do mundo, compilados em um conjunto de dados cavernoso que é atualizado a cada poucas horas
• 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 fácil de ler, completa com trechos de código
• Uma equipe de satisfação do cliente 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 por um punhado de marcadores, vamos dar um mergulho profundo em como é realmente usar a API.

Guia de início rápido de 3 etapas do Positionstack

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

1. Defina sua chave de acesso API - por padrão, você recebe uma chave de acesso pronta para uso. No entanto, você pode redefinir isso facilmente conforme necessário.
2. Escolha os endpoints da API - cobriremos os endpoints da API com mais detalhes na próxima seção, mas por enquanto, apenas entenda que esta etapa se refere à configuração de quais tipos de dados são retornados quando seu aplicativo faz uma solicitação ao Positionstack. É aqui que você verá primeiro o URL base, que é para onde você direciona suas solicitações, mas 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 do aplicativo - a última etapa refere-se à integração final da API do Positionstack em seu aplicativo. Há muito a saber sobre esse processo, e a maior parte dele é abordada na documentação. O importante aqui é: a equipe de suporte da Positionstack está à sua volta e oferecerá a ajuda necessária para configurar e integrar a API em seu aplicativo.

Muito fácil, certo? As APIs podem parecer intimidantes para quem não tem amplo conhecimento de TI no início. Mas logo de cara, a Positionstack o conforta com o conhecimento de que não só é fácil, como também o ajudará ao longo do caminho com uma documentação incrível de seu design inteligente. Isso os ajuda a ter uma equipe de especialistas apaixonados e prontos para ajudá-lo também.

Seu painel Positionstack

Dobrando seu valor central 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:

• Dashboard - aqui você encontrará notificações (geralmente alertando quando você ultrapassa certos limites de uso) e links para o Guia de início rápido de 3 etapas e sua página de documentação. Também há uma visão geral de sua chave API, sua assinatura atual, detalhes da conta e método de pagamento.
• Upgrade / Assinatura - Você pode alterar sua assinatura em qualquer uma dessas duas opções. Atualize a qualquer momento, embora se você quiser alternar entre um plano mensal ou anual em qualquer direção, você precisará primeiro fazer o downgrade para uma conta gratuita e, em seguida, escolher a opção desejada. O suporte da Positionstack está disposto a ajudá-lo se você precisar de ajuda para fazer isso.
• Conta / pagamento - são autoexplicativos; qualquer uma das guias permitirá que você atualize suas credenciais a qualquer momento. Devemos dizer que apreciamos que eles não enterrem esses controles básicos em uma interface exagerada e chamativa. WYSIWYG.
• Uso da API - Provavelmente a guia que você revisará com mais frequência, aqui você pode descobrir quanto de sua cota de solicitação mensal consumiu até agora. Há também 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 API

Agora chegamos ao coração e à alma da oferta do Positionstack: a documentação da API . Considere esta página como o seu manual do usuário, que detalha cada endpoint 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, gastando algum tempo e verbosidade para fornecer algum contexto para que você entenda 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. Estes são:

• Chave API - sua chave 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 ela foi comprometida, pode facilmente trocar sua chave antiga por uma nova.
• Criptografia - a criptografia SSL de 256 bits é usada em toda a Internet e é o padrão da indústria para segurança 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 da Positionstack, vale a pena investir por conta própria. Para evocar a criptografia, simplesmente altere HTTP para HTTPS na URL base da API. Simples!
• Callbacks JSON - Não entraremos em muitos detalhes técnicos de como isso funciona, mas se suas solicitações de API estão ficando bloqueadas por políticas de mesma origem, você usa callbacks JSON para afetar uma solução alternativa. Basicamente, você solicita dados de um script externo, que não se atola com problemas entre domínios.
• Erros de API - como com qualquer coisa, às vezes suas solicitações de API podem gerar erros. A Positionstack entende isso e incorporou em seu aplicativo uma funcionalidade de relatório de erros para ajudá-lo a identificar o que deu errado. As falhas de solicitação de 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.

Endpoints API

Esta seção documenta a funcionalidade essencial do Positionstack, ou seja, geocodificação direta e reversa. Se você não tiver 100% de certeza de qual é a diferença, pense na geocodificação como uma rua de mão dupla onde você pode traduzir lugares e endereços escritos em inglês para dados de localização, como coordenadas e endereços IP, e vice-versa.

Portanto, 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 da rua associado a um endereço IP usando geocodificação reversa. Afinal de contas, muito simples!

Solicitações de geocodificação direta / reversa

Para fazer uma solicitação básica para qualquer tipo de geocodificação, você precisará anexar o ponto de extremidade apropriado ( / forward  ou / reverse ) ao URL base da API. Em seguida, você fornecerá sua chave de acesso e fará uma consulta usando um endereço de localização em inglês simples ou seus dados de localização correspondentes - e voila! Será mais ou menos assim:

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 por meio do uso de vários parâmetros. Aqui está um exemplo de como é uma solicitação de geocodificação direta , consultando a Casa Branca:

{
   "dados": {
      "resultados": [
         {
            "latitude": 38,897675,
            "longitude": -77.036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA",
            "nome": "1600 Pennsylvania Avenue NW",
            "tipo": "endereço",
            "número": "1600",
            "rua": "Pennsylvania Avenue NW",
            "postal_code": "20500",
            "confiança": 1,
            "região": "Distrito de Columbia",
            "region_code": "DC",
            "administrativo_area": ​​nulo,
            "vizinhança": "Terrenos da Casa Branca",
            "país": "Estados Unidos",
            "country_code": "US",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

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

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 usar, você pode obter um complemento completo de dados de localização em troca. (É possível restringir esses resultados usando o parâmetro de campos  da API , mas tocaremos nisso mais tarde.)

Observação: a página de documentação do Positionstack detalha totalmente cada parâmetro e objeto de resposta, portanto, certifique-se de conferir!

Pedidos em lote

O último título principal nesta configuração de documentação lida com solicitações em lote . Tudo o que você precisa fazer é invocar o parâmetro batch  e, em seguida, aninhar várias instâncias de consulta (junto com seus parâmetros desejados) em uma única solicitação, e a API do Positionstack cuida do resto. É muito simples e tem a seguinte aparência:

{
   "lote":[
      {
         "query": "Main Street",
         "país": "EUA",
         "região": "Minnesota"
      },
      {
         "query": "Main Street",
         "país": "EUA",
         "região": "Illinois"
      },
      {
         "query": "Main Street",
         "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 dados mais 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 em seu site ou aplicativo.
• Módulo de 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. 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 chamada e muito mais.
• Módulo Sol - Bem humorado, a documentação do Positionstack descreve isso como dados “astrológicos”. Você não obterá seu horóscopo com este 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 - acrescente timezone_module para retornar o deslocamento GMT de um local em segundos ou como uma string de linguagem natural.
• Módulo de caixa delimitadora - se um único par de coordenadas x / y não for adequado para sua tarefa, tente uma caixa delimitadora, que inclui uma área com valores mínimo e máximo de longitude e latitude.

Opções adicionais

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

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

Exemplos de código 

Quando Positionstack diz que eles estão aqui para ajudá-lo, eles estão falando sério. Já vimos como sua documentação é completa, mas eles completam com exemplos de código úteis em todas as linguagens que sua API suporta. Não vamos copiar / colar esse código aqui, mas para referência rápida, essas linguagens são:

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

Prova e desempenho

Neste ponto, deve estar claro que o Positionstack é capaz de fazer muitas coisas. Mas, quão bem ele faz essas coisas?

Primeiro, vamos considerar algum contexto. 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 o início até a empresa. Alguns de seus clientes mais notáveis ​​incluem Amazon, Apple, Slack, LinkedIn e muitos outros nomes familiares. Claramente, eles têm alguma 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 escrita. Isso é ainda mais impressionante quando você considera que a API processa rotineiramente 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 clientes SMB estáveis. Além do mais, essas solicitações geralmente obtêm respostas entre 10 e 100 ms.

Em nosso livro, isso é uma espécie de 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, enviando atualizações regulares por meio de algoritmos inteligentes que garantem que você sempre tenha dados de localização altamente precisos, em qualquer lugar do mundo e em tempo real.

Odiamos estragar nosso veredicto final, mas se você está procurando uma solução de geocodificação robusta e escalável, 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 de nível empresarial altamente caro e, para esse fim, eles foram bem-sucedidos.

Positionstack vem em cinco níveis de preços e oferece suporte para faturamento mensal ou assinaturas anuais com um desconto de 20%. Essas camadas são:

• Gratuito - Classificado para uso pessoal, você ainda está obtendo uma boa quilometragem com 25.000 solicitações mensais para geocodificação direta e reversa, geradas no formato JSON. Você não obtém muitos recursos avançados ou suporte ao cliente, mas já mostramos como a página de documentação é um recurso valioso. Essa camada é gratuita e sem obrigações - você nem precisa fornecer detalhes do cartão de crédito para começar.
• Básico - 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 recursos avançados como criptografia HTTPS, várias opções de saída (JSON, XML, GeoJSON), mapas incorporáveis, vários idiomas e muito mais. Obtenha uma licença comercial Positionstack por apenas US $ 9,99 por mês.
• Profissional - a oferta mais popular da Positionstack, a camada Profissional oferece um aumento de dez vezes nas solicitações de geocodificação - até 1.000.000 por mês. Todas as vantagens da camada Básica estão presentes e, em seguida, algumas, incluindo solicitações em lote para aplicações pesadas. Esse nível é de US $ 49,99 por mês.
• Negócios - passando para o desempenho em escala empresarial, a camada de negócios eleva a cota mensal para incríveis 3.000.000 de solicitações. Mais uma vez, todos os recursos avançados estão totalmente disponíveis, com o apoio da apaixonada equipe de suporte ao cliente da Positionstack para ajudá-lo a obter o máximo deles. $ 99,99 por mês.
• Enterprise - este é o nível em que as ofertas padrão são descartadas e o cliente é o rei. Você tem necessidades precisas que exigem soluções personalizadas e a Positionstack está pronta para atingir seus objetivos. Você dita suas solicitações de volume mensal, mesmo (especialmente) se elas forem variáveis. Precisa de mais potência da API? Procure suporte para soluções personalizadas. Entre em contato com a Positionstack para obter uma cotação.

Veredito

A Positionstack faz exatamente o que se propôs a fazer: reduzir a geocodificação de nível empresarial dos pontos de preço que, de outra forma, estaria 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 máxima utilidade. O número de solicitações que o Positionstack trata rotineiramente é impressionante, enquanto seu conjunto de dados é mantido de forma inteligente para um alcance verdadeiramente global em 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 em seu negócio? Você tem perguntas ou comentários sobre o Positionstack? Deixe-nos uma nota nos comentários abaixo.