N-WaysQuotas e limites
Quanto cada chave pode pedir, como definir os seus próprios limites, e os limites de cada pedido.
Nesta página
Limites por omissão. Os limites abaixo aplicam-se a todas as chaves. O seu contrato pode fixar outros; peça-nos se precisar de mais.
Dois tipos de limites
- Os limites de débito protegem o serviço: quantos pedidos uma chave pode enviar por minuto a cada API. Acima disso, os pedidos recebem
429 RATE_LIMIT_EXCEEDEDaté ao fim do minuto. - Os limites diários fixam quanto uma chave pode consumir de uma API por dia, definidos na chave a seu pedido. Acima disso, os pedidos recebem
429 QUOTA_EXCEEDEDaté à meia-noite em Lagos (UTC+1).
Cada chave é contada à parte: uma chave que atinge o seu limite nunca torna mais lenta outra chave, sua ou de outra pessoa. O seu contrato pode também fixar limites para todo o projeto, todas as chaves em conjunto (por minuto e por dia, por API ou para todas as API): acima disso, cada chave do projeto recebe as mesmas respostas 429, e a mensagem indica que se trata do limite do projeto.
Limites de débito
| API | Por chave e por minuto | Contado como |
|---|---|---|
| Mapas (estilos, mosaicos e tipos de letra) | 6 000 pedidos | Cada leitura de estilo, mosaico ou tipo de letra (uma visualização de mapa lê de 10 a 30) |
| Mapas estáticos | 600 | Um por imagem |
| Geocodificação | 600 | Um por pedido; cada código de um lote de códigos postais |
| Preenchimento automático | 1 200 | Um por pedido (faturado por sessão) |
| Validação de endereços | 300 | Um por pedido |
| Lugares | 600 | Um por pedido |
| Percursos | 300 | Um por pedido |
| Matriz de percursos | 3 000 elementos | Partidas × chegadas |
| Otimização de percursos | 60 | Um por pedido |
| Tarifas | 120 | Um por pedido |
| Trânsito | 60 | Um por pedido |
| Frota | 6 000 | Um por pedido (um lote de posições conta como um) |
| Fluxo de trânsito | 60 | Um por pedido |
| Fotos | 600 | Um por foto |
Uma chave pode ter o seu próprio limite por API, mais alto ou mais baixo: indique-nos o seu pico esperado em hello@nways.ng.
Os seus próprios limites
Defina um limite diário por chave e por API na consola de parceiros: por exemplo, 20 000 pedidos de geocodificação por dia para a chave do seu site. Um limite impede que um erro no seu código, ou alguém que abuse de uma chave copiada, esgote as chamadas ou o crédito do seu projeto. A consola avisa-o a 50, 80 e 100% de um limite.
Consumo e faturação
Cada API tem chamadas gratuitas todos os meses (contadas por projeto e por mês civil, na hora de Lagos). As chamadas acima disso são faturadas por cada 1 000 aos preços publicados (ou aos do seu contrato), a partir do crédito pré-pago do seu projeto ou por fatura. Os tipos de letra do mapa nunca são faturados.
Com crédito pré-pago, quando este se esgota, as chamadas acima das chamadas gratuitas de uma API recebem 402 BILLING_DISABLED; as chamadas ainda dentro das chamadas gratuitas continuam a funcionar. O crédito adicionado na consola (Faturação → Adicionar crédito) aplica-se em poucos segundos.
Consumo
Contamos cada chamada por chave e por API; a consola de parceiros mostra-as por dia ou por hora, por API, chave, estado e motivo, com exportação CSV. Cada resposta a uma chamada autorizada traz cabeçalhos que pode registar:
| Cabeçalho | Significado |
|---|---|
X-RateLimit-Limit | Os pedidos que esta chave pode enviar por minuto a esta API (em vez disso, o limite do seu projeto, quando é o mais restrito) |
X-RateLimit-Remaining | O que resta neste minuto |
X-RateLimit-Reset | Os segundos até ao fim do minuto |
Retry-After | Num 429: os segundos a esperar |
Limites dos pedidos
| Limite | Valor |
|---|---|
| Geocodificação | Pesquisa até 200 caracteres; até 20 resultados; 100 códigos postais por lote |
| Preenchimento automático | Até 10 sugestões |
| Validação de endereços | Endereço até 300 caracteres |
| Lugares | Raio de 200 m a 50 km; nome até 60 caracteres; 40 resultados por página |
| Percursos | Até 25 paragens pelo caminho; até 2 alternativas (sem paragens) |
| Matriz de percursos | De 1 a 50 partidas e chegadas, 625 pares; pontos a menos de 400 km de carro (200 km nos outros casos) |
| Otimização de percursos | De 1 a 50 paragens, de 1 a 5 veículos |
| Mapas estáticos | De 32 a 1 280 px de lado; 100 marcadores; 10 traçados |
| Mosaicos | Intervalos de bytes até 8 MB, um intervalo por pedido (como os lê o SDK Maps) |
| Trânsito | Um retângulo com menos de 3° de largura (para o fluxo de trânsito: 2°) |
| Frota | 1 000 posições por pedido; 10 pontos de receção de webhooks |
| Cobertura | Nigéria, Gana, Benim, Togo, Gabão, Costa do Marfim, Libéria, Guiné, Serra Leoa, Guiné-Bissau, Senegal, Camarões, Burkina Faso, Cabo Verde e Gâmbia |
Utilização razoável
Não recolha em massa as API ou os mosaicos para fazer uma cópia dos dados do N-Ways, e não partilhe uma chave fora da sua organização. Os comportamentos invulgares (varrimento de grelhas de coordenadas, todos os mosaicos de um país, arquivos de mapa inteiros) são abrandados ou recusados, com ou sem chave. Atribuição e termos