Um die CO2-Emissionen einer Route berechnen zu können ist es erforderlich, dass Städte/Orte auf Geokoordinaten gemappt werden können. Dafür wurde ein eigener Algorithmus implementiert, welcher diese Angaben möglichst eindeutig zuordnen kann.
Gerade bei Ortsnamen, welche öfter existieren kann es sein, dass dieses Mapping nicht eindeutig ist. Das Service liefert in diesem Fall eine "warning", dass das Geocoding nicht eindeutig war.
Beispiel:
Über die Angabe einer Postleitzahl und/oder den 2-stelligen Länder-ISO-Code (z.B. AT, DE, CH, ...) können Orte weiter eingeschränkt werden.
Die Postleitzahl wird immer vor dem Ortsnamen angegeben, der ISO-Code am Ende der Zeile in folgenden Formaten: ",AT" oder "(AT)"
Als Ergebnis werden alle verfügbaren Daten zum angegeben Ort übermittelt (insbesondere die Geokoordinaten Latitude/Longitude). Da die Daten aus unterschiedlichen Datenquellen zusammengespielt werden stehen nicht alle Daten vollständig zur Verfügung (z.B. "population").
Für Österreich steht auch ein Geocoding auf Adressebene zur Verfügung. Details dazu finden Sie in der Online-Dokumentation unter https://cm.localhost.at/api-doc#W_III
Für die Berechnung der CO2-Emissionen ist neben einem Start- und Zielpunkt, dem API-Key ein weiterer Parameter erforderlich: Der Typ des Verkehrsmittels. Dieser kann ebenfalls über die URL mitangegeben werden.
Folgende Verkehrsmittel stehen aktuell zur Verfügung:
Als Ergebnis werden die gemappten "Orte/Städte" sowie die Berechnungsergebnisse zurückgeliefert.
Die wichtigsten Parameter sind:
Da Ortsnamen nicht immer eindeutig sind können auch direkt die Geokoordinaten angegeben werden.
Beispiel für "Auto":Es stehen eine Reihe an optionalen Parametern zur Verüfgung (z.b. die Anzeige der Wegpunkte für die Visualisierung in einer Map). Details dazu entnehmen sie bitte der Online-Dokumentation.