Substituto compatível (drop-in) do PositionStack

Os endpoints direto e reverso do PositionStack respondem em positionstack.mygeocode.com com o mesmo array data e os mesmos nomes de campo planos. Aqui o HTTPS está disponível em todos os planos, inclusive no gratuito.

Troque um nome de host

Host original	`api.positionstack.com`
Use no lugar	`positionstack.mygeocode.com`
Parâmetro da chave	`access_key` (opcional: qualquer endereço recebe 2.500 requisições por dia sem chave; coloque aqui sua chave do My Geocode para crédito, pacotes e histórico de uso)

Antes

curl "http://api.positionstack.com/v1/forward?access_key=YOUR_POSITIONSTACK_KEY&query=350+5th+Avenue+New+York"

Depois

curl "https://positionstack.mygeocode.com/v1/forward?access_key=YOUR_MYGEOCODE_KEY&query=350+5th+Avenue+New+York"

Por que as pessoas migram

O plano gratuito do PositionStack é só HTTP e tem limite mensal. Aqui tudo é HTTPS e a cota gratuita de cada chave é reiniciada diariamente.

A mesma cota gratuita, com ou sem chave. As requisições para positionstack.mygeocode.com contam para as mesmas 2.500 requisições gratuitas por dia que o seu endereço, ou a sua chave, recebe nos nossos próprios endpoints. Acima disso, crédito pré-pago a € 0,0001 por requisição, ou € 50 por mês por uma chave Unlimited. Para se cadastrar, basta um endereço de e-mail.

Ver preços Obtenha uma chave grátis

Endpoints

Caminho em positionstack.mygeocode.com	O que faz	Baseado em
`/v1/forward?query=...`	Geocodificação direta	Geocodificação direta
`/v1/reverse?query=lat,lng`	Geocodificação reversa	Geocodificação reversa

Exemplo de resposta

Isto é o que a requisição acima retorna. Nomes de campo, aninhamento e tipos seguem o PositionStack. Só os dados por trás deles são nossos.

Resposta de positionstack.mygeocode.com

{
  "data": [
    {
      "latitude": 40.748428,
      "longitude": -73.985654,
      "type": "address",
      "name": "350 5th Avenue",
      "number": "350",
      "postal_code": "10118",
      "street": "5th Avenue",
      "confidence": 1,
      "region": "New York",
      "region_code": "NY",
      "county": "New York County",
      "locality": "New York",
      "administrative_area": null,
      "neighbourhood": "Midtown",
      "country": "United States",
      "country_code": "USA",
      "continent": "North America",
      "label": "350 5th Avenue, New York, NY, USA"
    }
  ]
}

Detalhes e diferenças

Nenhuma chave é necessária para as primeiras 2.500 requisições por dia. Para usar uma chave do My Geocode, coloque-a onde ficava a sua chave do positionstack: o parâmetro de consulta access_key. O cabeçalho X-API-Key, Authorization: Bearer e a autenticação HTTP Basic (a chave como nome de usuário) também funcionam em todos os hosts, então bibliotecas cliente que se autenticam do próprio jeito continuam funcionando sem mudanças.

Tanto a direta quanto a reversa respondem no formato do array data.
Não há endpoint de lote, porque o original não tem. Para trabalho em massa, use POST /v1/forward ou /v1/reverse em api.mygeocode.com (até 100 por chamada, uma requisição cada).

Se o seu cliente depende de um campo ou comportamento que não está listado aqui, avise-nos. Lacunas de compatibilidade são corrigidas rapidamente porque costumam ser pequenas.

Outros hosts compatíveis

Como funcionam os hosts compatíveis, a visão geral e os substitutos para bibliotecas JavaScript.