Maps liefert keinen Treffer, eine Route endet mitten im Meer oder die Hausnummer fehlt? Fast immer steckt eine von wenigen typischen Ursachen dahinter. Hier findest du sie mit der passenden Lösung.
Die Route landet im Meer, in Afrika oder am falschen Ort
Das passiert fast immer, weil Längen- und Breitengrad vertauscht sind. In Maps gilt für origin, destination, waypoints und proximity immer die Reihenfolge Längengrad,Breitengrad. Für Berlin heißt das 13.4050,52.5200, nicht 52.5200,13.4050.
Gemein ist: Für Orte in Deutschland sind auch die vertauschten Werte gültige Koordinaten. Statt einer Fehlermeldung bekommst du dann ein Ergebnis an einer ganz anderen Stelle der Welt oder einen 404, weil dort keine Straße ist.
Zur Orientierung, wo welcher Name gilt:
| Wo | Schreibweise |
|---|---|
Maps-Routen und proximity |
ein Wert Längengrad,Breitengrad |
| Maps-Geocoding | zwei Parameter lat und lng |
| Maps-Antworten | Felder lat und lng |
| IP Geolocation | Felder lat und lon |
Übernimmst du Koordinaten aus IP Geolocation, heißt der Längengrad dort lon. Den Wert gibst du in Maps als lng oder an erster Stelle weiter.
HTTP 422: Invalid parameters
Ein Parameter fehlt oder hat einen ungültigen Wert. Unter details steht immer das betroffene Feld mit einer Meldung, zum Beispiel:
{"success":false,"error":"Invalid parameters","details":{"country":["Das Feld country muss 2 Zeichen lang sein."]}}
Häufige Ursachen:
- Der Suchbegriff
qfehlt oder ist länger als 256 Zeichen. countryhat nicht genau zwei Buchstaben. Richtig istDE, nichtDEUoderDeutschland.limitliegt nicht zwischen 1 und 10.- Beim Geocoding fehlt
address, oder es ist nurlatohnelnggesetzt. - Bei der Route fehlt
originoderdestination,profileist kein bekannter Wert, oderalternativessteht auftruestatt auf1.
HTTP 404: nichts gefunden
Maps konnte keine Adresse oder Route ermitteln. Der Text in error sagt dir, welcher Endpunkt betroffen ist:
No address data found for this address: Geocoding hat zur Adresse nichts gefunden. Prüfe Schreibweise, Postleitzahl undcountry.No address found for the specified coordinates: Am Punkt liegt keine bekannte Adresse, oft weil Koordinaten vertauscht sind.No route found for the specified coordinates: Zwischen den Punkten gibt es keine Route für das gewählte Verkehrsmittel, oder ein Wert beiavoidist ungültig.
Die Ortssuche antwortet dagegen nie mit 404. Findet sie nichts, ist die Liste addresses einfach leer. Solche Antworten werden wie alle Fehler nicht berechnet.
Im Protokoll des Bereichs siehst du jede fehlgeschlagene Anfrage mit Parameter und Fehlerantwort. Stell den Filter auf Fehlgeschlagen und klicke beim Eintrag auf das Augensymbol.
In den Treffern fehlen Hausnummern
Die Ortssuche liefert auch Straßen, Postleitzahlen und Orte. Treffer ohne Hausnummer stehen immer hinter den vollständigen Adressen. Fehlt die Hausnummer überall, kennt Maps sie für diese Straße nicht, oder dein Suchbegriff enthält keine. Gib die Hausnummer mit ein, oder schränke die Suche mit types=address auf Adressen ein.
Treffer im falschen Land
Ohne country sucht Maps weltweit. Eine „Hauptstraße 5“ gibt es in vielen Ländern. Setze country=DE oder das passende Land, und für Treffer in der Nähe eines bestimmten Ortes zusätzlich proximity.
HTTP 500: Serverfehler
Ein Serverfehler kann zwei Gründe haben:
- Bei der Route sind die Koordinaten falsch formatiert, zum Beispiel mit Leerzeichen statt Komma, mit drei Werten oder mit Werten außerhalb des gültigen Bereichs. Die Antwort lautet dann
{"message":"Server Error"}. Prüfe zuerst das Format. Auch ein unbekannter Wert beitypeskann zu einem Serverfehler führen. - Der Kartendienst war gerade nicht erreichbar. Warte einen Moment und versuch es erneut.
Darf ich die Ergebnisse speichern?
Nein, nicht auf Vorrat. Der Hinweis im Feld attribution jeder erfolgreichen Antwort besagt, dass die Antwort und ihre Daten nicht dauerhaft gespeichert werden dürfen. Nutze die Ergebnisse direkt, zum Beispiel für die Anzeige oder die Auswahl einer Adresse, und frag bei Bedarf neu an.
Gut zu wissen
Die Grundlagen zu den drei Endpunkten stehen hier: