My Geocode

Drop-in-Ersatz für Bing Maps REST Services

Microsoft stellt Bing Maps for Enterprise ein. Kostenlose und Basis-Schlüssel funktionieren seit dem 30. Juni 2025 nicht mehr, und Enterprise-Verträge enden am 30. Juni 2028. Wenn Sie Code haben, der auf den REST-Diensten Locations, Autosuggest, Time Zone oder Elevation aufbaut, richten Sie ihn auf bing.mygeocode.com aus und behalten Sie dieselbe Verarbeitung der Antworten bei.

Einen Hostnamen ändern

Ursprünglicher Host
  • dev.virtualearth.net
Stattdessen verwendenbing.mygeocode.com
Schlüsselparameterkey (optional: Jede Adresse erhält 2.500 Anfragen pro Tag ohne Schlüssel; setzen Sie hier Ihren My Geocode Schlüssel ein für Guthaben, Pakete und einen Nutzungsverlauf)
Vorher
curl "https://dev.virtualearth.net/REST/v1/Locations?q=1%20Microsoft%20Way%2C%20Redmond%2C%20WA&key=YOUR_BING_KEY"
Nachher
curl "https://bing.mygeocode.com/REST/v1/Locations?q=1%20Microsoft%20Way%2C%20Redmond%2C%20WA&key=YOUR_MYGEOCODE_KEY"

Warum Nutzer wechseln

Die Bing-Endpunkte werden nach einem festen Zeitplan abgeschaltet. Eine Migration zu Azure Maps bedeutet neue Antwortstrukturen und neuen Client-Code. Das Ändern eines Hostnamens nicht.

Gleiches kostenloses Kontingent, mit oder ohne Schlüssel. Anfragen an bing.mygeocode.com zählen zu denselben 2.500 kostenlosen Anfragen pro Tag, die Ihre Adresse oder Ihr Schlüssel auf unseren eigenen Endpunkten erhält. Darüber hinaus Prepaid-Guthaben zu 0,0001 € pro Anfrage oder 50 € pro Monat für einen Unlimited-Schlüssel. Für die Registrierung brauchen Sie nur eine E-Mail-Adresse, sonst nichts.

Preise ansehen Kostenlosen Schlüssel holen

Endpunkte

Pfad auf bing.mygeocode.comFunktionBasiert auf
/REST/v1/Locations?q=...Einen Ort per Suchanfrage findenGeokodierung
/REST/v1/Locations?countryRegion=...&locality=...&addressLine=...Einen Ort per strukturierter Adresse findenGeokodierung
/REST/v1/Locations/{lat},{lon}Einen Ort per Punkt finden (Reverse)Reverse-Geokodierung
/REST/v1/Autosuggest?query=...AutosuggestAdress-Autovervollständigung
/REST/v1/TimeZone/{lat},{lon}Zeitzone per PunktZeitzonen-Abfrage
/REST/v1/Elevation/List?points=lat,lon,lat,lonHöhen für eine Liste von PunktenHöhenabfrage

Beispielantwort

Das liefert die obige Anfrage. Feldnamen, Verschachtelung und Typen folgen Bing Maps. Nur die Daten dahinter stammen von uns.

Antwort von 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"
}

Details und Unterschiede

Für die ersten 2.500 Anfragen pro Tag ist kein Schlüssel nötig. Um einen My Geocode Schlüssel zu verwenden, setzen Sie ihn dort ein, wo Ihr Bing Maps Schlüssel stand: im Query-Parameter key. Der Header X-API-Key, Authorization: Bearer und HTTP-Basic-Authentifizierung (der Schlüssel als Benutzername) funktionieren ebenfalls auf jedem Host, sodass Client-Bibliotheken, die sich auf ihre eigene Weise authentifizieren, unverändert weiter funktionieren.

Copyright-Zeilen, Lizenznamen, Nutzungsbedingungen und Datenschutz-Links in der Antwort stammen von uns statt vom ursprünglichen Anbieter. Alles andere behält die ursprüngliche Struktur.

  • Höhenanfragen akzeptieren die Punkte im Query-String, in einem Formular-Body oder in dem von Bing dokumentierten text/plain-Body.
  • Elevation/SeaLevel antwortet mit 404: Die Höhen beziehen sich hier bereits auf den mittleren Meeresspiegel, daher ist kein Geoid-Offset anzuwenden.
  • Zeitzonen-Antworten enthalten das Objekt dstRule, mit der Regel in der Schreibweise der Zeitzonendatenbank (Sun>=8, lastSun) und der Anpassung in Minuten.
  • estimatedTotal zählt die Ressourcen in der Ergebnismenge, wie bei Bing.
  • TimeZone?query= erwartet ein Paar aus Breiten- und Längengrad.
  • Elevation List, Polyline und Bounds akzeptieren bis zu 1.024 Punkte, wie bei Bing; jeder Punkt zählt hier als eine Anfrage.

Wenn Ihr Client von einem Feld oder Verhalten abhängt, das hier nicht aufgeführt ist, sagen Sie es uns. Kompatibilitätslücken werden schnell geschlossen, weil sie meist klein sind.

Weitere Drop-in-Hosts

So funktionieren die Drop-in-Hosts, der Überblick und die Drop-ins für JavaScript-Bibliotheken.