My Geocode

Substituto compatível (drop-in) do Bing Maps REST Services

A Microsoft está descontinuando o Bing Maps for Enterprise. As chaves gratuitas e básicas pararam de funcionar em 30 de junho de 2025 e os contratos enterprise terminam em 30 de junho de 2028. Se você tem código construído sobre os serviços REST Locations, Autosuggest, Time Zone ou Elevation, aponte-o para bing.mygeocode.com e mantenha a mesma interpretação das respostas.

Troque um nome de host

Host original
  • dev.virtualearth.net
Use no lugarbing.mygeocode.com
Parâmetro da chavekey (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://dev.virtualearth.net/REST/v1/Locations?q=1%20Microsoft%20Way%2C%20Redmond%2C%20WA&key=YOUR_BING_KEY"
Depois
curl "https://bing.mygeocode.com/REST/v1/Locations?q=1%20Microsoft%20Way%2C%20Redmond%2C%20WA&key=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

Os endpoints do Bing vão ser desativados em um cronograma fixo. Migrar para o Azure Maps significa novos formatos de resposta e novo código no cliente. Trocar um nome de host, não.

A mesma cota gratuita, com ou sem chave. As requisições para bing.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 bing.mygeocode.comO que fazBaseado em
/REST/v1/Locations?q=...Encontrar um local por consultaGeocodificação direta
/REST/v1/Locations?countryRegion=...&locality=...&addressLine=...Encontrar um local por endereço estruturadoGeocodificação direta
/REST/v1/Locations/{lat},{lon}Encontrar um local por ponto (reverso)Geocodificação reversa
/REST/v1/Autosuggest?query=...AutosuggestPreenchimento automático de endereços
/REST/v1/TimeZone/{lat},{lon}Fuso horário por pontoConsulta de fuso horário
/REST/v1/Elevation/List?points=lat,lon,lat,lonAltitudes para uma lista de pontosConsulta de altitude

Exemplo de resposta

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

Resposta de bing.mygeocode.com
{
  "authenticationResultCode": "ValidCredentials",
  "brandLogoUri": "https://www.mygeocode.com/assets/img/logo.svg",
  "copyright": "Copyright My Geocode",
  "resourceSets": [
    {
      "estimatedTotal": 1,
      "resources": [
        {
          "__type": "Location:http://schemas.microsoft.com/search/local/ws/rest/v1",
          "bbox": [47.635742, -122.140518, 47.643468, -122.125237],
          "name": "1 Microsoft Way, Redmond, WA 98052",
          "point": { "type": "Point", "coordinates": [47.639605, -122.129877] },
          "address": {
            "addressLine": "1 Microsoft Way",
            "adminDistrict": "WA",
            "adminDistrict2": "King County",
            "countryRegion": "United States",
            "formattedAddress": "1 Microsoft Way, Redmond, WA 98052",
            "locality": "Redmond",
            "postalCode": "98052"
          },
          "confidence": "High",
          "entityType": "Address",
          "geocodePoints": [
            { "type": "Point", "coordinates": [47.639605, -122.129877], "calculationMethod": "Rooftop", "usageTypes": ["Display"] }
          ],
          "matchCodes": ["Good"]
        }
      ]
    }
  ],
  "statusCode": 200,
  "statusDescription": "OK",
  "traceId": "mg-7f2a9c1e4b"
}

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

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.

  • As requisições de altitude aceitam os pontos na query string, em um corpo de formulário ou no corpo text/plain que o Bing documenta.
  • Elevation/SeaLevel responde 404: aqui as alturas já estão acima do nível médio do mar, então não há deslocamento de geoide a aplicar.
  • As respostas de fuso horário incluem o objeto dstRule, com a regra escrita do jeito que o banco de dados de fusos horários a escreve (Sun>=8, lastSun) e o ajuste em minutos.
  • estimatedTotal conta os recursos do conjunto, como o Bing faz.
  • TimeZone?query= recebe um par de latitude e longitude.
  • Elevation List, Polyline e Bounds aceitam até 1.024 pontos, como o Bing; aqui cada ponto conta como uma requisição.

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.