Substituto compatível (drop-in) do Mapbox Geocoding

Tanto a antiga Geocoding API v5 quanto os endpoints atuais da v6 respondem em mapbox.mygeocode.com. Os resultados são FeatureCollections GeoJSON com os mesmos arrays context, valores de place_type e ordem de coordenadas de que os clientes do Mapbox dependem.

Troque um nome de host

Host original	`api.mapbox.com`
Use no lugar	`mapbox.mygeocode.com`
Parâmetro da chave	`access_token` (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 "https://api.mapbox.com/geocoding/v5/mapbox.places/1%20Market%20St%20San%20Francisco.json?access_token=YOUR_MAPBOX_TOKEN"

Depois

curl "https://mapbox.mygeocode.com/geocoding/v5/mapbox.places/1%20Market%20St%20San%20Francisco.json?access_token=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

O Mapbox cobra de forma diferente a geocodificação temporária e a permanente e vincula o uso a uma conta com cartão cadastrado. Aqui, os resultados são seus para guardar, e as primeiras 2.500 requisições por dia de cada chave são gratuitas.

A mesma cota gratuita, com ou sem chave. As requisições para mapbox.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 mapbox.mygeocode.com	O que faz	Baseado em
`/geocoding/v5/mapbox.places/{query}.json`	Geocodificação direta, v5	Geocodificação direta
`/geocoding/v5/mapbox.places/{lon},{lat}.json`	Geocodificação reversa, v5	Geocodificação reversa
`/search/geocode/v6/forward?q=...`	Geocodificação direta, v6	Geocodificação direta
`/search/geocode/v6/reverse?longitude=...&latitude=...`	Geocodificação reversa, v6	Geocodificação reversa
`/search/searchbox/v1/suggest?q=...`	Sugestões do Search Box	Preenchimento automático de endereços

Exemplo de resposta

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

Resposta de mapbox.mygeocode.com (v5)

{
  "type": "FeatureCollection",
  "query": ["1", "market", "st", "san", "francisco"],
  "features": [
    {
      "id": "address.mg.us.4d2e8b10",
      "type": "Feature",
      "place_type": ["address"],
      "relevance": 1,
      "properties": { "accuracy": "rooftop" },
      "text": "Market Street",
      "place_name": "1 Market Street, San Francisco, California 94105, United States",
      "center": [-122.394626, 37.793858],
      "geometry": { "type": "Point", "coordinates": [-122.394626, 37.793858] },
      "address": "1",
      "context": [
        { "id": "neighborhood.mg.us.fidi", "text": "Financial District" },
        { "id": "postcode.mg.us.94105", "text": "94105" },
        { "id": "place.mg.us.sanfrancisco", "wikidata": "Q62", "text": "San Francisco" },
        { "id": "region.mg.us.ca", "short_code": "US-CA", "text": "California" },
        { "id": "country.mg.us", "short_code": "us", "text": "United States" }
      ]
    }
  ],
  "attribution": "My Geocode, https://www.mygeocode.com/terms/"
}

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 Mapbox: o parâmetro de consulta access_token. 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.

Linhas de copyright, nomes de licença e links de termos e privacidade na resposta são nossos, e não do provedor original. Todo o resto mantém o formato original.

Tanto o endpoint Places da v5 quanto os endpoints de busca da v6 são roteados, junto com o endpoint suggest do Search Box.
POST /search/geocode/v6/batch com um array JSON de até 1.000 objetos de consulta (direta com q ou reversa com longitude/latitude) responde {"batch": [...]} com uma FeatureCollection por consulta, como o Mapbox faz; cada consulta conta como uma requisição, da mesma forma que o Mapbox conta.

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.