VEZOO Public API v1

API VEZOO pour itinéraires et logistique

Intégrez le calcul routier, l’autocomplétion, le géocodage et les points d’intérêt le long du trajet dans vos services.

Couverture actuelle : Russie, CEI, Europe, Amérique du Nord et du Sud, Moyen-Orient et Égypte.

OpenAPI 3.1 décrit paramètres, bodies, en-têtes, erreurs, scopes et exemples.

Accès d’essai

Après inscription, envoyez une demande d’accès API depuis votre espace développeur. L’administrateur vérifie l’usage, les scopes et la charge avant que la clé apparaisse dans votre compte.

Authentification

Envoyez Authorization: Bearer <api-key>. Les clés peuvent être désactivées ou renouvelées.

Accès commercial

Plan, scopes, RPM, quota, expiration et browser origins peuvent être configurés par client.

Démarrage rapide

Obtenez une clé, calculez une route puis utilisez route.polyline pour les POI et arrêts intelligents.

1
Demander un accès
Authorization: Bearer <api-key>
2
POST /route
from + to + optional vias
3
route.polyline
Use the returned encoded polyline
4
POI / insights
Pass polyline to trip endpoints

Enchaînement des méthodes

La route est la base. Sa polyline est envoyée à /places/along-route et /trip-insights.

STEP 1
POST /route

Returns distance, duration, segments and route.polyline.

STEP 2
POST /places/along-route

Use the polyline to fetch roadside objects by category.

STEP 3
POST /trip-insights

Use the same polyline for stop suggestions and smart trip planning.

Méthodes API

GET/citiesscope: cities≤ 120 RPM

Autocomplete / location search

Paramètres
q: string (2–80, required) · limit: integer (1–20, default 10)
GET/geocodescope: geocode≤ 30 RPM

Forward and reverse geocoding

Paramètres
q: string OR lat + lon
GET | POST/routescope: route≤ 60 RPM

Road route with up to 12 via points and exclusions

Paramètres
from, to · vias[] / v · exclude: toll,motorway,ferry
POST/places/along-routescope: places≤ 20 RPM

Fuel, food, lodging, service, tyres, parking and charging

Paramètres
polyline · categories[] (optional)
POST/trip-insightsscope: insights≤ 12 RPM

Suggested stops and automatic trip plan

Paramètres
polyline

Limites

La limite effective est la plus basse entre la limite client et celle de l’endpoint. Dépassement : HTTP 429.

cities 120 · route 60 · geocode 30 · places 20 · insights 12 RPM

Scopes

Chaque clé peut être limitée aux méthodes nécessaires.

citiesroutegeocodeplacesinsights

Browser origins

Les requêtes navigateur peuvent être limitées à une liste d’Origin autorisés.

Exemples prêts à l’emploi

cURL · route
curl -G 'https://vezoo.ru/api/v1/route' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'from=Москва' \
  --data-urlencode 'to=Казань' \
  --data-urlencode 'v=Владимир' \
  --data-urlencode 'exclude=ferry'
JavaScript · route
const response = await fetch('https://vezoo.ru/api/v1/route', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: 'Москва',
    to: 'Казань',
    vias: ['Владимир'],
    exclude: ['ferry'],
  }),
});
const data = await response.json();
console.log(data.route.polyline);
cURL · places along route
curl -X POST 'https://vezoo.ru/api/v1/places/along-route' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "polyline":"ENCODED_POLYLINE_FROM_ROUTE",
    "categories":["fuel","food","lodging","parking","charging"]
  }'
PHP · route
$payload = json_encode([
    'from' => 'Москва',
    'to' => 'Казань',
]);
$ch = curl_init('https://vezoo.ru/api/v1/route');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
JSON · route response
{
  "success": true,
  "from": "Москва",
  "to": "Казань",
  "via": [],
  "exclude": [],
  "route": {
    "kilometers": 817.4,
    "minutes": 667,
    "polyline": "...",
    "segments": [...]
  }
}

Erreurs

Les erreurs d’authentification et de quota utilisent des error_code stables. Validation : HTTP 422.

HTTPerror_codeMeaning
401invalid_api_keyMissing or invalid key
401api_key_disabledKey was disabled
401api_key_expiredKey expired
403scope_forbiddenScope is not allowed
403origin_forbiddenBrowser Origin is not allowed
404not_found / unknown_location / no_routeLocation or route was not found
422validation errorRequest parameters are invalid
429rate_limit_exceededPer-minute limit exceeded
429quota_exceededTotal key quota exhausted
503api_disabled / api_not_configuredPublic API unavailable
503service_unavailableRequired routing service unavailable

En-têtes de réponse

Utilisez X-Request-Id pour le support et X-RateLimit-* pour gérer le trafic.

X-API-Version

API version used for the response

X-Request-Id

Unique request identifier for diagnostics

X-RateLimit-Limit

Effective requests-per-minute limit

X-RateLimit-Remaining

Requests remaining in the current minute

X-Quota-Limit

Total quota when configured for this key

X-Quota-Remaining

Remaining total quota

Retry-After

Seconds before retrying after HTTP 429

Base URL

https://vezoo.ru/api/v1

Authentication: Authorization: Bearer YOUR_API_KEY