Substitutos compatíveis (drop-in) para outras APIs de geocodificação

Trocar de provedor de geocodificação normalmente significa reescrever o código que interpreta as respostas. Preferimos que você não precise fazer isso. Cada host abaixo aceita os caminhos e parâmetros da API de um provedor e responde no formato JSON desse provedor, com os nossos dados por trás. Troque o nome do host, coloque sua chave do My Geocode onde ficava a antiga e publique. Uma chave grátis pede seu nome, um endereço de e-mail e um minuto.

  1. Encontre seu provedor abaixo

    Cada página lista o host original, o host substituto e todos os caminhos suportados.

  2. Troque o host na sua configuração

    Por exemplo, maps.googleapis.com passa a ser gapi.mygeocode.com. Caminhos e parâmetros continuam os mesmos.

  3. Troque a chave

    Coloque sua chave do My Geocode no mesmo parâmetro que a chave antiga usava. Uma chave grátis tem 2.500 requisições por dia.

Hosts REST

Google Maps Platform

maps.googleapis.com → gapi.mygeocode.com

Os serviços web Geocoding, Places Autocomplete, Time Zone e Elevation respondem todos nos mesmos caminhos em gapi.mygeocode.com, com a mesma estrutura de JSON que o Google retorna.

Endpoints e formato de resposta

Bing Maps REST Services

dev.virtualearth.net → bing.mygeocode.com

A Microsoft está descontinuando o Bing Maps for Enterprise.

Endpoints e formato de resposta

HERE Geocoding and Search

geocode.search.hereapi.com, revgeocode.search.hereapi.com, autosuggest.search.hereapi.com, autocomplete.search.hereapi.com → here.mygeocode.com

A HERE divide sua API de busca entre vários hosts.

Endpoints e formato de resposta

Mapbox Geocoding

api.mapbox.com → mapbox.mygeocode.com

Tanto a antiga Geocoding API v5 quanto os endpoints atuais da v6 respondem em mapbox.mygeocode.com.

Endpoints e formato de resposta

Geocode.Farm

api.geocode.farm, www.geocode.farm → farm.mygeocode.com

Os endpoints direto e reverso do Geocode.Farm, nos estilos de URL v3 e v4, respondem em farm.mygeocode.com.

Endpoints e formato de resposta

OpenStreetMap Nominatim

nominatim.openstreetmap.org → osm.mygeocode.com

A instância pública do Nominatim pede no máximo uma requisição por segundo e nenhum uso intenso.

Endpoints e formato de resposta

OpenCage

api.opencagedata.com → opencage.mygeocode.com

O OpenCage usa um único endpoint para geocodificação direta e reversa e retorna um bloco de anotações detalhado.

Endpoints e formato de resposta

LocationIQ

us1.locationiq.com, eu1.locationiq.com → locationiq.mygeocode.com

Os endpoints de busca, reverso, preenchimento automático e fuso horário do LocationIQ respondem em locationiq.mygeocode.com.

Endpoints e formato de resposta

Geoapify

api.geoapify.com → geoapify.mygeocode.com

Os endpoints de geocodificação do Geoapify retornam FeatureCollections GeoJSON com um objeto properties plano.

Endpoints e formato de resposta

TomTom Search

api.tomtom.com → tomtom.mygeocode.com

Os endpoints Geocode, Reverse Geocode e Fuzzy Search da TomTom respondem em tomtom.mygeocode.com com a mesma estrutura de summary e results, incluindo o campo freeformAddress que a maioria das integrações exibe.

Endpoints e formato de resposta

MapQuest Geocoding

www.mapquestapi.com, open.mapquestapi.com → mapquest.mygeocode.com

Tanto o endpoint de geocodificação licenciado quanto o Open Data do MapQuest respondem em mapquest.mygeocode.com, com o envelope info, options e results e a nomenclatura adminArea1 a adminArea6 que os clientes do MapQuest interpretam.

Endpoints e formato de resposta

Geocodio

api.geocod.io → geocodio.mygeocode.com

O Geocodio se concentra nos Estados Unidos e no Canadá.

Endpoints e formato de resposta

PositionStack

api.positionstack.com → positionstack.mygeocode.com

Os endpoints direto e reverso do PositionStack respondem em positionstack.mygeocode.com com o mesmo array data e os mesmos nomes de campo planos.

Endpoints e formato de resposta

ip-api.com

ip-api.com, pro.ip-api.com → ipapi.mygeocode.com

O endpoint JSON do ip-api é um dos formatos de consulta de IP mais copiados.

Endpoints e formato de resposta

ipinfo.io

ipinfo.io → ipinfo.mygeocode.com

O JSON compacto do ipinfo, com uma string loc e uma string org prefixada pelo número AS, é reproduzido em ipinfo.mygeocode.com.

Endpoints e formato de resposta

ipstack

api.ipstack.com → ipstack.mygeocode.com

Os endpoints de consulta padrão e check do ipstack respondem em ipstack.mygeocode.com com os mesmos campos de nível superior e o mesmo objeto location, por HTTPS em todos os planos.

Endpoints e formato de resposta

Open-Elevation

api.open-elevation.com → openelevation.mygeocode.com

O servidor público do Open-Elevation é um projeto voluntário sem garantia de disponibilidade.

Endpoints e formato de resposta

Bibliotecas JavaScript

A mesma abordagem funciona para bibliotecas de mapas e de geocodificação. Carregue a Google Maps JavaScript API a partir de gapi.mygeocode.com e google.maps.Map, Geocoder e places.Autocomplete continuam funcionando com os nossos tiles e dados, sem cobrança por carregamento de mapa. Há loaders para o controle Bing Maps V8, HERE Maps for JavaScript e MapQuest.js, e configurações para MapLibre e Mapbox GL com mapbox-gl-geocoder, e para os plugins de geocodificação do Leaflet.

Substitutos compatíveis para JavaScript Referência completa e checklist de migração

O que é igual e o que não é

Igual

  • Caminhos, parâmetros de consulta e métodos HTTP documentados pelo provedor.
  • Estrutura da resposta: nomes de campo, aninhamento, arrays, tipos e ordem das coordenadas.
  • Vocabulários de status, por exemplo OK e ZERO_RESULTS do Google ou statusCode do Bing.
  • Formatos de erro, para que o seu tratamento de erros atual continue funcionando.
  • Preços. Uma requisição a um host de compatibilidade custa o mesmo que uma requisição ao nosso próprio endpoint e usa a mesma cota da chave.

Diferente

  • Os dados. Coordenadas, endereços formatados e valores de confiança são nossos, então não vão coincidir dígito por dígito com os do provedor original.
  • Identificadores. Os Place IDs são nossos e são estáveis, mas não podem ser passados ao provedor original.
  • Recursos fora de geocodificação, IP, fuso horário e altitude, como rotas, detalhes de lugares e fotos, não estão incluídos. Cada página lista o que falta.
  • Chaves. Uma chave de pagamento por uso funciona a partir de dois endereços IP a cada 24 horas contínuas e uma chave Unlimited a partir de três, como nos nossos próprios endpoints. Use mais chaves ou pacotes para frotas maiores.

Seu provedor não está na lista?

Adicionar um host de compatibilidade leva alguns dias de trabalho quando o formato do provedor está documentado. Se você usa um serviço que não está aqui, diga qual é e mais ou menos quantas requisições por dia você envia.