Drop-in-Ersatz für OpenCage

OpenCage verwendet einen Endpunkt für Geokodierung und Reverse-Geokodierung und liefert einen umfangreichen annotations-Block. opencage.mygeocode.com macht es genauso, einschließlich der Annotationen für Zeitzone, Währung, Ländervorwahl und im Stil von what3words, die OpenCage-Nutzer auslesen.

Einen Hostnamen ändern

Ursprünglicher Host	`api.opencagedata.com`
Stattdessen verwenden	`opencage.mygeocode.com`
Schlüsselparameter	`key` (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://api.opencagedata.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_OPENCAGE_KEY"

Nachher

curl "https://opencage.mygeocode.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_MYGEOCODE_KEY"

Warum Nutzer wechseln

Gleiche Anfrage, gleiche Antwortstruktur, 2.500 kostenlose Anfragen pro Tag pro Schlüssel, ohne Pflicht zur Quellenangabe und ohne Klausel zur nicht kommerziellen Nutzung.

Gleiches kostenloses Kontingent, mit oder ohne Schlüssel. Anfragen an opencage.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 opencage.mygeocode.com	Funktion	Basiert auf
`/geocode/v1/json?q=...`	Geokodierung	Geokodierung
`/geocode/v1/json?q=lat,lng`	Reverse-Geokodierung	Reverse-Geokodierung
`/geocode/v1/geojson?q=...`	GeoJSON-Ausgabe	Geokodierung

Beispielantwort

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

Antwort von opencage.mygeocode.com

{
  "documentation": "https://www.mygeocode.com/compatibility/opencage/",
  "licenses": [ { "name": "My Geocode Terms", "url": "https://www.mygeocode.com/terms/" } ],
  "rate": { "limit": 2500, "remaining": 2483, "reset": 1756339200 },
  "results": [
    {
      "annotations": {
        "DMS": { "lat": "41° 53' 24.72'' N", "lng": "12° 29' 31.92'' E" },
        "callingcode": 39,
        "currency": { "iso_code": "EUR", "name": "Euro", "symbol": "€" },
        "flag": "🇮🇹",
        "timezone": { "name": "Europe/Rome", "now_in_dst": 1, "offset_sec": 7200, "offset_string": "+0200", "short_name": "CEST" }
      },
      "bounds": {
        "northeast": { "lat": 41.8905, "lng": 12.4932 },
        "southwest": { "lat": 41.8897, "lng": 12.4914 }
      },
      "components": {
        "ISO_3166-1_alpha-2": "IT",
        "ISO_3166-1_alpha-3": "ITA",
        "_category": "travel/tourism",
        "_type": "attraction",
        "attraction": "Colosseo",
        "city": "Roma",
        "continent": "Europe",
        "country": "Italia",
        "country_code": "it",
        "postcode": "00184",
        "road": "Piazza del Colosseo",
        "state": "Lazio"
      },
      "confidence": 9,
      "formatted": "Colosseo, Piazza del Colosseo, 00184 Roma RM, Italia",
      "geometry": { "lat": 41.8902, "lng": 12.4922 }
    }
  ],
  "status": { "code": 200, "message": "OK" },
  "total_results": 1
}

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 OpenCage-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.

Der Block rate meldet Ihr tatsächliches kostenloses Kontingent, was davon übrig ist und wann es zurückgesetzt wird.
Sowohl der json- als auch der geojson-Endpunkt werden unterstützt.
Kein Batch-Endpunkt, weil das Original keinen hat. Für Massenverarbeitung verwenden Sie POST /v1/forward oder /v1/reverse auf api.mygeocode.com (bis zu 100 pro Aufruf, jeweils 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.