Quick reference

1
-H "tomtom-api-key: YOUR_API_KEY"
2
-H "Authorization: Bearer YOUR_AUTH_TOKEN"

1
-H "Content-Type: application/json"

1
az account get-access-token --scope https://gem.core.orbis.tomtom.com/user_impersonation

1
az login --service-principal \
2
  --username <CLIENT_ID> \
3
  --password <CLIENT_SECRET> \
4
  --tenant <TENANT_ID>

1
az storage blob upload \
2
  --account-name <STORAGE_ACCOUNT> \
3
  --container-name <CONTAINER> \
4
  --name <FILENAME>.parquet \
5
  --file /path/to/local/file.parquet \
6
  --auth-mode login

1
az storage blob download \
2
  --account-name <STORAGE_ACCOUNT> \
3
  --container-name <CONTAINER> \
4
  --name <FILENAME>.results.parquet \
5
  --file /path/to/destination/<FILENAME>.results.parquet \
6
  --auth-mode login

1
{"id": 5707295, "is_navigable": true, "geometry": "LINESTRING (4.89 52.37, 4.90 52.38)"}

1
{"id":"abc","gers":"550e8400-e29b-41d4-a716-446655440000","confidence":99,"lr_id":"52.0197-76.36744#550e8400-e29b-41d4-a716-446655440000","lr_gers":"0.0-100.0#abc"}

1
curl -X GET "https://api.tomtom.com/maps/orbis/platform/private-gateway/storages" \
2
  -H "tomtom-api-key: $TOMTOM_API_KEY" \
3
  -H "Authorization: Bearer $AUTH_TOKEN"

1
curl -X GET "https://api.tomtom.com/maps/orbis/platform/private-gateway/storages/$STORAGE_ID/credentials?type=READ_WRITE" \
2
  -H "tomtom-api-key: $TOMTOM_API_KEY" \
3
  -H "Authorization: Bearer $AUTH_TOKEN"

1
curl -X POST "https://api.tomtom.com/maps/orbis/platform/gem/jobs" \
2
  -H "tomtom-api-key: $TOMTOM_API_KEY" \
3
  -H "Authorization: Bearer $AUTH_TOKEN" \
4
  -H "Content-Type: application/json" \
5
  -d '{
6
    "storage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
7
    "filename": "my_data.parquet",
8
    "job_type": "ROAD_MATCHING",
9
    "overture_release": "2026-01-21.0"
10
  }'

1
curl -X GET "https://api.tomtom.com/maps/orbis/platform/gem/jobs/$JOB_ID" \
2
  -H "tomtom-api-key: $TOMTOM_API_KEY" \
3
  -H "Authorization: Bearer $TOKEN"

1
curl -X PATCH "https://api.tomtom.com/maps/orbis/platform/gem/jobs/$JOB_ID" \
2
  -H "tomtom-api-key: $TOMTOM_API_KEY" \
3
  -H "Authorization: Bearer $AUTH_TOKEN" \
4
  -H "Content-Type: application/json" \
5
  -d '{"action": "CANCEL"}'