Drop-in-Ersatz für HERE Geocoding and Search

HERE verteilt seine Such-API auf mehrere Hosts. Sie alle laufen bei here.mygeocode.com zusammen, das mit demselben items-Array, address-Objekt und position-Objekt antwortet, das HERE-Clients auslesen.

Einen Hostnamen ändern

Ursprünglicher Host	`geocode.search.hereapi.com` `revgeocode.search.hereapi.com` `autosuggest.search.hereapi.com` `autocomplete.search.hereapi.com`
Stattdessen verwenden	`here.mygeocode.com`
Schlüsselparameter	`apiKey` (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://geocode.search.hereapi.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_HERE_KEY"

Nachher

curl "https://here.mygeocode.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_MYGEOCODE_KEY"

Warum Nutzer wechseln

HERE rechnet pro Transaktion mit monatlichen Mindestabnahmen ab. Eine einzige Änderung des Hostnamens bringt Ihnen 2.500 kostenlose Aufrufe pro Tag pro Adresse, mit oder ohne Schlüssel, und danach Pauschal- oder Preise pro Anfrage.

Gleiches kostenloses Kontingent, mit oder ohne Schlüssel. Anfragen an here.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 here.mygeocode.com	Funktion	Basiert auf
`/v1/geocode?q=...`	Geokodierung	Geokodierung
`/v1/geocode?qq=street=...;city=...`	Geokodierung mit qualifizierter Abfrage	Geokodierung
`/v1/revgeocode?at=lat,lng`	Reverse-Geokodierung	Reverse-Geokodierung
`/v1/autosuggest?q=...&at=lat,lng`	Autosuggest	Adress-Autovervollständigung
`/v1/autocomplete?q=...`	Autovervollständigung	Adress-Autovervollständigung

Beispielantwort

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

Antwort von here.mygeocode.com

{
  "items": [
    {
      "title": "Invalidenstraße 116, 10115 Berlin, Deutschland",
      "id": "mg.de.addr.9a3f1c77",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Invalidenstraße 116, 10115 Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "district": "Mitte",
        "street": "Invalidenstraße",
        "postalCode": "10115",
        "houseNumber": "116"
      },
      "position": { "lat": 52.53041, "lng": 13.38527 },
      "access": [ { "lat": 52.53039, "lng": 13.38533 } ],
      "mapView": { "west": 13.38393, "south": 52.52951, "east": 13.38661, "north": 52.53131 },
      "scoring": {
        "queryScore": 1.0,
        "fieldScore": { "city": 1.0, "streets": [1.0], "houseNumber": 1.0, "postalCode": 1.0 }
      }
    }
  ]
}

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 HERE-Schlüssel stand: im Query-Parameter apiKey (apikey wird ebenfalls akzeptiert) oder als Bearer-Token. 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.

Fehler verwenden die HERE-Felder title, status, code, cause und action mit einer Correlation-ID.
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.