...

Basisadresse für alle Abfragen ist http://map.yellowfox.de/rti/ bzw https://map.yellowfox.de/rti/

Fehlerwerte

Bei der Rückgabe "ERROR:Text" enthält "Text" die Fehlerbeschreibung. Mögliche Fehler:

Beschreibung der Funktionsweise

...

• ERROR_$Parameter (Parameter ist nicht korrekt)
• ERROR_MISSING_$Parameter (Parameter fehlt)
• ERROR_MISSING_COMPANY (Key zur Authentifizierung der Firma fehlt)
• ERROR_MISSING_SESSIONKEY|VEHICLE|GROUP (Es wurde keiner von 3 möglichen Parametern übergeben)
• ERROR_MISSING_SESSIONKEY (Der Parmater "sessionkey" fehlt)
• ERROR_MISSING_VEHICLE (Der Parameter "vehicle" fehlt)
• ERROR_MISSING_GROUP (Der Parameter "group" fehlt)
• ERROR_MISSING_DISTANCE (Der Parameter "distance" fehlt)
• ERROR_MISSING_CYCLE (Der Parameter "cycle" fehlt)
• ERROR_MISSING_RADIUS (Der Parameter "radius" fehlt)
• ERROR_MISSING_CUSTOMORDERID - Eigene Auftragsnummer fehlt
• ERROR_MISSING_ORDERTEXT - Auftragstext fehlt
• ERROR_ORDER_NUMBER_TOO_LONG(MAX_20_CHARS) - Eigene Auftragsnummer zu lang, maximal 20 Zeichen
• ERROR_STREET_TOO_LONG(MAX_100_CHARS) - Straßenname zu lang, maximal 100 Zeichen
• ERROR_HOUSENUMBER_TOO_LONG(MAX_100_CHARS) - Hausnummer zu lang, maximal 100 Zeichen
• ERROR_ZIPCODE_TOO_LONG(MAX_10_CHARS)- Postleitzahl zu lang, maximal 10 Zeichen
• ERROR_CITY_TOO_LONG(MAX_100_CHARS) - Stadt zu lang, maximal 100 Zeichen
• ERROR_COUNTRY_TOO_LONG(MAX_100_CHARS) - Land zu lang, maximal 3 Zeichen
• ERROR_LATITUDE_MISSING - Latitude Wert wurde nicht angegeben
• ERROR_LONGITUDE_MISSING - Longitude Wert wurde nicht angegeben
• ERROR_LATITUDE_NOT_NUMERIC - Latitude Wert muss eine Zahl sein
• ERROR_LONGITUDE_NOT_NUMERIC - Longitude Wert muss eine Zahl sein
• ERROR_LATITUDE_NOT_IN_VALID_RANGE(-90_TO_90) - Latitude muss im Bereich von -90 bis +90 liegen
• ERROR_LONGITUDE_NOT_IN_VALID_RANGE(-90_TO_90) - Longitude muss im Bereich von -90 bis +90 liegen
• ERROR_TARGET_TIME_IS_INVALID - Angegebens Datum hat nicht die richtige Länge
• ERROR_TARGET_TIME_IS_NOT_A_DATE - Angegebenes Datum ist kein richtiges Datum
• ERROR_FORMULAR_NOT_ALLOCATED_BY_VEHICLE - Angegebenes Formular wurde der Hardware nicht zugeordnet
• ERROR_FORMULAR_NOT_SUPPORTED_BY_HARDWARE - Hardware unterstützt keine Aufträge mit angehängten benutzerdef. Formularen
• ERROR_ORDER_TEXT_TOO_LONG(MAX_300_CHARS) - Auftragstext ist zu lang, maximal 300 Zeichen (ACHTUNG: Bei Garmins wird die erwartete Ankunftszeit und die Adresse an den Anfang der Nachricht gesetzt, dies verringert die maximale Anzahl der Zeichen für den Auftragstext)
• ERROR_COMPANY (Authentifizierung der Firma fehlerhaft)
• ERROR_VEHICLE (Es wurde eine ungültige Fahrzeugkennung übergeben)
• ERROR_GROUP (Es wurde eine ungültige Fahrzeuggruppe übergeben)
• ERROR_DISTANCE (Der Parameter "distance" ist fehlerhaft)
• ERROR_CYCLE (Der Parameter "cycle" ist fehlerhaft)
• ERROR_RADIUS (Der Parameter "radius" ist fehlerhaft)
• ERROR_DUPLICATE_CUSTOMORDERID (Auftragsnummer mehrfach vorhanden, Aktion nicht ausführbar)
• ERROR_ORDER_NOT_FOUND (Der Angeforderte Auftrag konnte nicht gefunden werden)
• ERROR_TEXT_TOO_LONG (Auftragstext und eigene Auftragsnummer überschreiten die maximale Länge).
• ERROR_GROUP_NOMEMBER (Die abgefragte Fahrzeuggruppe enthält keinerlei Fahrzeuge)
• ERROR_MAINTENANCE (aus Wartungsgründen nicht verfügbar)
• REQUEST_NOT_FOUND (interner Fehler)
• ERROR_NOT_SUPPORTED_BY_HARDWARE (Die Hardware im Fahrzeug unterstützt diese Aktion nicht)

Serverfehler

...

Folgende Parameter sind für die Anmeldung an YellowFox wichtig:

• company, als HEXadezimalKey auszuführen, kann vom Kunden selber neu generiert werden. Dieser Key wird in jeder Anfrage mitgesendet. Antworten enthalten diesen Key nicht. Der Key dient zur Authentifizierung. Dieser Key wird pro Kunde generiert und enthält unter anderem die Firmenid

• vehicle, als HEXadezimalKey auszuführen, kann vom Kunden selber neu generiert werden. Dieser Key wird bei Anfragen die Fahrzeuge betreffen mitgesendet. Antworten enthalten diesen Key nicht. Der Key dient als Fahrzeugkennung. Dieser Key wird pro Fahrzeug generiert.

• group, als HEXadezimalKey auszuführen, kann vom Kunden selber neu generiert werden. Dieser Key wird bei Anfragen die Fahrzeuggruppen betreffen mitgesendet. Antworten enthalten diesen Key nicht. Der Key dient als Fahrzeugkennung oder Gruppenkennung. Dieser Key wird pro Gruppe generiert. Wenn Sie einen Gruppenschlüssel verwenden, stellen Sie sicher, dass jedes Fahrzeug dieser Gruppe auch einen Fahrzeugschlüssel hat!

• Datumsstempel, um Caching der Befehlsanfrage zu vermeiden.

Ausführung als ?company=HEXKEY&vehicle=HEXKEY2&ts=yyyymmddhhmmsszzzzzzzz

• yyyy = Jahr, vierstellig
• mm - Monat, zweistellig
• dd - Tag, zweistellig
• hh - Stunde, zweistellig
• mm - Minute, zweistellig
• ss - Sekunde, zweistellig
• zzzzzzzz - Zaehler für Anfrage, die Antwort enthält diesen Zaehler

Fehlerwerte

Bei der Rückgabe "ERROR:Text" enthält "Text" die Fehlerbeschreibung. Mögliche Fehler:

Abarbeitungsfehler

Mögliche Fehlercodes werden unter Fehlerwerte beschrieben.

...