My Geocode

Drop-in-Ersatz für TomTom Search

Die Endpunkte Geocode, Reverse Geocode und Fuzzy Search von TomTom antworten unter tomtom.mygeocode.com mit derselben summary- und results-Struktur, einschließlich des Feldes freeformAddress, das die meisten Integrationen anzeigen.

Einen Hostnamen ändern

Ursprünglicher Host
  • api.tomtom.com
Stattdessen verwendentomtom.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://api.tomtom.com/search/2/geocode/Avenida%20Paulista%201578%20S%C3%A3o%20Paulo.json?key=YOUR_TOMTOM_KEY"
Nachher
curl "https://tomtom.mygeocode.com/search/2/geocode/Avenida%20Paulista%201578%20S%C3%A3o%20Paulo.json?key=YOUR_MYGEOCODE_KEY"

Warum Nutzer wechseln

Der kostenlose Tarif von TomTom umfasst 2.500 Transaktionen pro Tag, genauso viel wie bei uns, aber eine Transaktion kann dort mehrere Credits kosten. Hier ist jeder Aufruf eine Anfrage, und für bezahlte Nutzung gibt es eine Pauschaloption.

Gleiches kostenloses Kontingent, mit oder ohne Schlüssel. Anfragen an tomtom.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 tomtom.mygeocode.comFunktionBasiert auf
/search/2/geocode/{query}.jsonGeokodierungGeokodierung
/search/2/structuredGeocode.json?countryCode=...&streetName=...Strukturierte GeokodierungGeokodierung
/search/2/reverseGeocode/{lat},{lon}.jsonReverse-GeokodierungReverse-Geokodierung
/search/2/search/{query}.json?typeahead=trueFuzzy-Suche mit TypeaheadAdress-Autovervollständigung

Beispielantwort

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

Antwort von tomtom.mygeocode.com
{
  "summary": {
    "query": "avenida paulista 1578 sao paulo",
    "queryType": "NON_NEAR",
    "queryTime": 21,
    "numResults": 1,
    "offset": 0,
    "totalResults": 1,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "Point Address",
      "id": "mg.br.addr.7d1a55f2",
      "score": 11.98,
      "address": {
        "streetNumber": "1578",
        "streetName": "Avenida Paulista",
        "municipalitySubdivision": "Bela Vista",
        "municipality": "São Paulo",
        "countrySecondarySubdivision": "São Paulo",
        "countrySubdivision": "São Paulo",
        "countrySubdivisionCode": "SP",
        "postalCode": "01310-200",
        "countryCode": "BR",
        "country": "Brasil",
        "countryCodeISO3": "BRA",
        "freeformAddress": "Avenida Paulista 1578, Bela Vista, São Paulo, SP 01310-200",
        "localName": "São Paulo"
      },
      "position": { "lat": -23.561414, "lon": -46.655881 },
      "viewport": {
        "topLeftPoint": { "lat": -23.560514, "lon": -46.656881 },
        "btmRightPoint": { "lat": -23.562314, "lon": -46.654881 }
      }
    }
  ]
}

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

  • Freitext-, strukturierte und Reverse-Geokodierung werden alle weitergeleitet, dazu der Such-Endpunkt.
  • Antworten behalten die summary- und results-Struktur von TomTom bei.
  • Batch Search funktioniert auf beide Arten. POST /search/2/batch/sync.json beantwortet bis zu 100 batchItems auf einmal in der Struktur von TomTom (statusCode und response pro Eintrag, summary). POST /search/2/batch.json akzeptiert bis zu 10.000, antwortet mit 202 und einem Location-Header, und das Ergebnis wird von dort abgerufen. Jeder Batch-Eintrag zählt als eine Anfrage, so wie TomTom zählt; ein Batch, der größer ist als das verbleibende Kontingent, wird vollständig mit dem 429 von TomTom abgelehnt, und der Abruf eines gespeicherten Ergebnisses zählt nichts.

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.