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.
Enchaînement des méthodes
La route est la base. Sa polyline est envoyée à /places/along-route et /trip-insights.
POST /routeReturns distance, duration, segments and route.polyline.
POST /places/along-routeUse the polyline to fetch roadside objects by category.
POST /trip-insightsUse the same polyline for stop suggestions and smart trip planning.
Méthodes API
/citiesscope: cities≤ 120 RPMAutocomplete / location search
q: string (2–80, required) · limit: integer (1–20, default 10)/geocodescope: geocode≤ 30 RPMForward and reverse geocoding
q: string OR lat + lon/routescope: route≤ 60 RPMRoad route with up to 12 via points and exclusions
from, to · vias[] / v · exclude: toll,motorway,ferry/places/along-routescope: places≤ 20 RPMFuel, food, lodging, service, tyres, parking and charging
polyline · categories[] (optional)/trip-insightsscope: insights≤ 12 RPMSuggested stops and automatic trip plan
polylineLimites
La limite effective est la plus basse entre la limite client et celle de l’endpoint. Dépassement : HTTP 429.
Scopes
Chaque clé peut être limitée aux méthodes nécessaires.
citiesroutegeocodeplacesinsightsBrowser origins
Les requêtes navigateur peuvent être limitées à une liste d’Origin autorisés.
Exemples prêts à l’emploi
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'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 -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"]
}'$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);{
"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.
| HTTP | error_code | Meaning |
|---|---|---|
| 401 | invalid_api_key | Missing or invalid key |
| 401 | api_key_disabled | Key was disabled |
| 401 | api_key_expired | Key expired |
| 403 | scope_forbidden | Scope is not allowed |
| 403 | origin_forbidden | Browser Origin is not allowed |
| 404 | not_found / unknown_location / no_route | Location or route was not found |
| 422 | validation error | Request parameters are invalid |
| 429 | rate_limit_exceeded | Per-minute limit exceeded |
| 429 | quota_exceeded | Total key quota exhausted |
| 503 | api_disabled / api_not_configured | Public API unavailable |
| 503 | service_unavailable | Required 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-VersionAPI version used for the response
X-Request-IdUnique request identifier for diagnostics
X-RateLimit-LimitEffective requests-per-minute limit
X-RateLimit-RemainingRequests remaining in the current minute
X-Quota-LimitTotal quota when configured for this key
X-Quota-RemainingRemaining total quota
Retry-AfterSeconds before retrying after HTTP 429
Base URL
https://vezoo.ru/api/v1Authentication: Authorization: Bearer YOUR_API_KEY