Die Skynet Navigator Routing API berechnet zu einer Startadresse und mehreren Zieladressen die optimierte Reihenfolge, die Teilstrecken und die Gesamtwerte. Ein einzelner REST-Endpunkt, ansprechbar aus jedem System — auch aus Zapier und Make.
track)distance)geocode)POST https://kwoxghmhudacyfplqnwx.supabase.co/functions/v1/route-api
Jede Anfrage braucht zwei Header:
| Header | Wert |
|---|---|
Content-Type | application/json |
x-api-key | Dein API-Key, z. B. sknav_xxxxxxxx… |
Den API-Key bekommst du über die SQL-Funktion im Supabase-Projekt (siehe Abschnitt 7). Der Key wird nur als Hash gespeichert — geht er verloren, muss ein neuer erzeugt werden.
Der Body ist ein JSON-Objekt mit folgenden Feldern:
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
start | Text | ja | Startadresse |
stops | Liste von Text | ja | Zieladressen (1–25) |
returnToStart | true/false | nein | Rückkehr zum Start am Ende (Standard: false) |
POST /functions/v1/route-api
Content-Type: application/json
x-api-key: sknav_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{
"start": "Wolfener Str. 32, 12681 Berlin",
"stops": [
"Alexanderplatz 1, 10178 Berlin",
"Kurfürstendamm 234, 10719 Berlin",
"Friedrichstr. 100, 10117 Berlin"
],
"returnToStart": true
}
Bei Erfolg (HTTP 200) liefert die API die optimierte Reihenfolge, alle Teilstrecken und die Gesamtwerte:
{
"ok": true,
"optimized_order": [
{ "position": 0, "address": "Wolfener Str. 32, 12681 Berlin",
"resolved_address": "...", "lat": 52.52, "lng": 13.51, "role": "start" },
{ "position": 1, "address": "Alexanderplatz 1, 10178 Berlin",
"lat": 52.52, "lng": 13.41, "role": "stop" }
],
"legs": [
{ "from": "Wolfener Str. 32...", "to": "Alexanderplatz 1...",
"distance_m": 9120, "duration_s": 1080 }
],
"totals": {
"distance_m": 28400, "distance_km": 28.4,
"duration_s": 3360, "duration_min": 56
},
"meta": { "stops_in": 3, "return_to_start": true,
"source": "OpenStreetMap / OSRM (Demo) — internal use only" }
}
| Feld | Bedeutung |
|---|---|
optimized_order | Stopps in der optimierten Reihenfolge, mit Koordinaten und Rolle (start / stop / return) |
legs | Teilstrecken zwischen je zwei Punkten, mit Distanz (m) und Dauer (s) |
totals | Gesamtstrecke und Gesamtfahrzeit, in Metern/Sekunden und gerundet in km/min |
track)
Für Telematik- und GPS-Anbieter: Sie schicken die aufgezeichneten Positionen einer Fahrt,
die API legt sie aufs Straßennetz und liefert die tatsächlich gefahrenen Straßenkilometer.
Gleicher Endpunkt, gleicher API-Key, zusätzlich das Feld action.
{
"action": "track",
"points": [
{ "lat": 52.5219, "lng": 13.4132, "t": 1792000000 },
{ "lat": 52.5205, "lng": 13.4098, "t": 1792000020 },
…
],
"reverse": true
}
| Feld | Bedeutung |
|---|---|
points | Mindestens 2, höchstens 5.000 Positionen in Fahrtreihenfolge. t ist optional (Unix-Sekunden) und verbessert die Zuordnung. |
reverse | Optional. Bei true werden Start- und Zieladresse als lesbare Anschrift ermittelt. |
Antwort (gekürzt):
{
"ok": true,
"distance_km": 189.1,
"duration_s": 7840,
"gps_duration_s": 7920,
"start": { "lat": 52.5219, "lng": 13.4132, "address": "Alexanderstraße 4, 10178 Berlin", "t": 1792000000 },
"end": { "lat": 51.3406, "lng": 12.3747, "address": "Salzgäßchen 3, 04109 Leipzig", "t": 1792007920 },
"quality": {
"match_confidence": 0.95,
"points_in": 642, "points_matched": 362, "spacing_m": 351,
"segments": 41, "segments_straight_line": 0
}
}
match_confidence liegt zwischen 0 und 1.
Ist segments_straight_line größer als 0, ließ sich ein Abschnitt nicht aufs
Straßennetz legen und wurde als Luftlinie gezählt; die Kilometer sind dann zu niedrig.
Im Test lag die Abweichung zur geplanten Route bei 0,8 % (Berlin–Leipzig) bzw. 1,6 % (Berlin–Potsdam).
distance)Straßendistanz und Fahrzeit zwischen zwei Punkten. Jeder Punkt darf eine Adresse oder eine Koordinate sein.
{ "action": "distance", "from": "Alexanderplatz 1, Berlin", "to": { "lat": 52.3906, "lng": 13.0661 } }
Antwortfelder: distance_km, duration_min, straight_line_m (Luftlinie) sowie die aufgelösten Punkte from und to.
geocode){ "action": "geocode", "address": "Alexanderplatz 1, 10178 Berlin" }
Antwort:
{
"ok": true,
"address": "Alexanderplatz 1, 10178 Berlin",
"lat": 52.52127,
"lng": 13.412683,
"resolved_address": "Alexanderplatz 1, 10178 Berlin"
}
geocode und distance gehen auch als einfache URL. Der Schlüssel bleibt im Header x-api-key.
GET /functions/v1/route-api?action=geocode&address=Alexanderplatz%201%2C%2010178%20Berlin
GET /functions/v1/route-api?action=distance&from=52.5219,13.4132&to=52.3906,13.0661
from und to als Breitengrad,Längengrad oder als Adresse. track und die Tourenoptimierung brauchen POST.
Fehler kommen als JSON mit Feld error und passendem HTTP-Status:
| Status | Bedeutung |
|---|---|
| 400 | Body ungültig oder Pflichtfeld fehlt |
| 401 | API-Key-Header fehlt |
| 403 | API-Key ungültig oder deaktiviert |
| 429 | Rate-Limit erreicht (Standard: 30 Anfragen/Minute pro Key) |
| 422 | Adresse nicht gefunden oder Routing-Dienst-Fehler |
| 400 | Bei track: weniger als 2 oder mehr als 5.000 gültige Punkte. Unbekannte action. |
Es ist keine eigene Zapier-App nötig — Zapier kann die API über den eingebauten Baustein Webhooks by Zapier ansprechen.
POSThttps://kwoxghmhudacyfplqnwx.supabase.co/functions/v1/route-apifalse stellen.{
"start": "Wolfener Str. 32, 12681 Berlin",
"stops": ["Alexanderplatz 1, 10178 Berlin", "Friedrichstr. 100, 10117 Berlin"],
"returnToStart": true
}
Content-Type = application/json und
x-api-key = dein API-Key.totals, legs …) stehen
danach in den Folgeschritten zur Verfügung.In Make (ehemals Integromat) übernimmt das Modul HTTP › Make a request die Anbindung.
https://kwoxghmhudacyfplqnwx.supabase.co/functions/v1/route-apiPOSTContent-Type : application/jsonx-api-key : dein API-KeyRaw, Content type: JSON (application/json)Yes stellen — dann zerlegt Make
die Antwort automatisch in einzelne Felder.API-Keys werden direkt im Supabase-Projekt über den SQL-Editor erzeugt. Der Klartext-Key wird nur einmal angezeigt — danach ist nur noch der Hash gespeichert.
Am einfachsten im Admin-Backend unter dem Reiter API. Alternativ per SQL:
select nav_create_api_key('Zapier Produktion');
select id, label, active, rate_limit_per_min, created_at, last_used_at
from nav_api_keys order by created_at desc;
update nav_api_keys set active = false where id = '<key-id>';
select endpoint, stops_count, ok, created_at
from nav_api_usage order by created_at desc limit 50;