N-WaysQuotas et limites
Ce que chaque clé peut demander, comment fixer vos propres plafonds, et les limites de chaque requête.
Sur cette page
Limites par défaut. Les limites ci-dessous s’appliquent à toutes les clés. Votre contrat peut en fixer d’autres ; demandez-nous si vous avez besoin de plus.
Deux sortes de limites
- Les limites de débit protègent le service : combien de requêtes une clé peut envoyer par minute à chaque API. Au-delà, les requêtes reçoivent
429 RATE_LIMIT_EXCEEDEDjusqu’à la fin de la minute. - Les plafonds journaliers fixent combien une clé peut consommer d’une API par jour, réglés sur la clé à votre demande. Au-delà, les requêtes reçoivent
429 QUOTA_EXCEEDEDjusqu’à minuit à Lagos (UTC+1).
Chaque clé est comptée séparément : une clé qui atteint sa limite ne ralentit jamais une autre clé, la vôtre ou celle de quelqu’un d’autre. Votre contrat peut aussi fixer des limites pour tout votre projet, toutes ses clés ensemble (par minute et par jour, par API ou pour toutes les API) : au-delà, chaque clé du projet reçoit les mêmes réponses 429, et le message précise qu’il s’agit de la limite du projet.
Limites de débit
| API | Par clé et par minute | Compté comme |
|---|---|---|
| Cartes (styles, tuiles et polices) | 6 000 requêtes | Chaque lecture de style, de tuile ou de police (un affichage de carte en lit de 10 à 30) |
| Cartes statiques | 600 | Une par image |
| Géocodage | 600 | Une par requête ; chaque code d’un lot de codes postaux |
| Saisie semi-automatique | 1 200 | Une par requête (facturée par session) |
| Validation d’adresse | 300 | Une par requête |
| Lieux | 600 | Une par requête |
| Itinéraires | 300 | Une par requête |
| Matrice d’itinéraires | 3 000 éléments | Départs × arrivées |
| Optimisation de tournées | 60 | Une par requête |
| Tarifs de course | 120 | Une par requête |
| Trafic | 60 | Une par requête |
| Flotte | 6 000 | Une par requête (un lot de positions compte pour une) |
| Flux de trafic | 60 | Une par requête |
| Photos | 600 | Une par photo |
Une clé peut avoir sa propre limite par API, plus haute ou plus basse : indiquez-nous votre pic attendu à hello@nways.ng.
Vos propres plafonds
Fixez un plafond journalier par clé et par API dans la console partenaire : par exemple 20 000 requêtes de géocodage par jour pour la clé de votre site web. Un plafond empêche un bug dans votre code, ou quelqu’un qui abuse d’une clé copiée, d’épuiser les appels ou le crédit de votre projet. La console vous prévient à 50, 80 et 100 % d’un plafond.
Consommation et facturation
Chaque API a des appels gratuits chaque mois (comptés par projet et par mois calendaire, à l’heure de Lagos). Les appels au-delà sont facturés par tranche de 1 000 aux prix publiés (ou à ceux de votre contrat), soit sur le crédit prépayé de votre projet, soit sur facture. Les polices de la carte ne sont jamais facturées.
Avec un crédit prépayé, quand il est épuisé, les appels au-delà des appels gratuits d’une API reçoivent 402 BILLING_DISABLED ; les appels encore compris dans les appels gratuits continuent de fonctionner. Le crédit ajouté dans la console (Facturation → Ajouter du crédit) s’applique en quelques secondes.
Consommation
Nous comptons chaque appel par clé et par API ; la console partenaire les affiche par jour ou par heure, par API, clé, statut et motif, avec un export CSV. Chaque réponse à un appel autorisé porte des en-têtes que vous pouvez enregistrer :
| En-tête | Signification |
|---|---|
X-RateLimit-Limit | Les requêtes que cette clé peut envoyer par minute à cette API (la limite de votre projet à la place, quand c’est la plus stricte) |
X-RateLimit-Remaining | Ce qui reste pour cette minute |
X-RateLimit-Reset | Les secondes jusqu’à la fin de la minute |
Retry-After | Sur un 429 : les secondes à attendre |
Limites des requêtes
| Limite | Valeur |
|---|---|
| Géocodage | Recherche jusqu’à 200 caractères ; jusqu’à 20 résultats ; 100 codes postaux par lot |
| Saisie semi-automatique | Jusqu’à 10 suggestions |
| Validation d’adresse | Adresse jusqu’à 300 caractères |
| Lieux | Rayon de 200 m à 50 km ; nom jusqu’à 60 caractères ; 40 résultats par page |
| Itinéraires | Jusqu’à 25 arrêts en chemin ; jusqu’à 2 variantes (sans arrêts) |
| Matrice d’itinéraires | De 1 à 50 départs et arrivées, 625 paires ; points à moins de 400 km en voiture (200 km sinon) |
| Optimisation de tournées | De 1 à 50 arrêts, de 1 à 5 véhicules |
| Cartes statiques | De 32 à 1 280 px de côté ; 100 marqueurs ; 10 tracés |
| Tuiles | Plages d’octets jusqu’à 8 Mo, une plage par requête (comme les lit le SDK Maps) |
| Trafic | Un rectangle de moins de 3° de large (pour le flux de trafic : 2°) |
| Flotte | 1 000 positions par requête ; 10 points de réception de webhooks |
| Couverture | Nigeria, Ghana, Bénin, Togo, Gabon, Côte d’Ivoire, Libéria, Guinée, Sierra Leone, Guinée-Bissau, Sénégal, Cameroun, Burkina Faso, Cap-Vert et Gambie |
Usage raisonnable
N’aspirez pas les API ou les tuiles pour constituer une copie des données de N-Ways, et ne partagez pas une clé en dehors de votre organisation. Les comportements inhabituels (balayage de grilles de coordonnées, toutes les tuiles d’un pays, des archives de carte entières) sont ralentis ou refusés, avec ou sans clé. Attribution et conditions