N-Ways
Documentação para programadoresVisão geral

Visão geral da plataforma

Mapas, endereços e percursos feitos para a Nigéria, o Gana, o Benim, o Togo, o Gabão, a Costa do Marfim, a Libéria, a Guiné, a Serra Leoa, a Guiné-Bissau, o Senegal, os Camarões, o Burkina Faso, Cabo Verde e a Gâmbia, para as aplicações que lá transportam pessoas e encomendas: códigos postais NIPOST, GhanaPost e Plus Codes, percursos de okada (mototáxi) e keke, tarifas em naira, cedis, F CFA, dólares liberianos, francos guineenses, leones e escudos.

Nesta página
Nota:

Registo. Crie a sua conta na consola de parceiros com a sua conta Google ou Apple ou um e-mail profissional, e obtenha a sua chave num minuto. Utilização gratuita todos os meses. Dúvidas: hello@nways.ng.

Quatro formas de usar o N-Ways: qual é a sua

No registo, a consola pergunta qual destas lhe corresponde e põe primeiro aquilo de que precisa. Nada fica bloqueado: todas as API e todas as páginas da consola continuam abertas, e pode mudar a sua resposta nas Definições.

ÉUsaComece por
Uma empresa com a sua própria aplicação, como um serviço de transporte por aplicação ou de entregas, que lhe acrescenta mapas e percursosAs API e os SDK: mapas, geocodificação, percursos e horas de chegada, seguimento; chaves, utilização e webhooksPrimeiros passos
Uma empresa sem sistema próprio que quer fazer do N-Ways todo o seu sistema de despachoA Frota da consola: entregas, mapa em direto, os seus estafetas na aplicação N-Ways Business e motoristas N-Ways. Sem códigoAbrir uma consola de despacho
Uma empresa que despacha aqui e mantém o seu ERP (SAP, Odoo, Dynamics) em diaA mesma consola, mais webhooks para cada evento, a exportação e a API de FrotaLigar o seu ERP
Uma empresa de tecnologia ou de logística que constrói o seu próprio produto sobre a nossa plataforma de despachoA API de Frota, os webhooks, os SDK, projetos de teste e o simuladorSeguimento de frota

Porquê o N-Ways

O N-Ways é uma aplicação de navegação gratuita feita só para a Nigéria, o Gana, o Benim, o Togo, o Gabão, a Costa do Marfim, a Libéria, a Guiné, a Serra Leoa, a Guiné-Bissau, o Senegal, os Camarões, o Burkina Faso, Cabo Verde e a Gâmbia. Os mesmos mapas, a mesma pesquisa e o mesmo cálculo de percursos estão agora abertos à sua aplicação: os seus estafetas, motoristas e clientes recebem percursos à medida destas estradas:

  • Os endereços que as pessoas usam de facto. Os códigos postais NIPOST da Nigéria até ao edifício, os endereços GhanaPost GPS, os códigos de casa N-Ways (por país), os Plus Codes, os pontos de referência e os nomes de ruas em inglês e francês.
  • Todas as formas de se deslocar. Carro, okada (mototáxi), keke, danfo, a pé, comboio e barco, com as proibições de okada e keke respeitadas, e um táxi ou autocarro que assume onde a viagem não pode ir.
  • Quanto deve custar. Preços justos para táxis, okadas, kekes, autocarros e barcos, em naira, em cedis, em F CFA, em dólares liberianos, em francos guineenses, em leones e em escudos, a partir do que os passageiros pagaram.
  • Um mapa que os seus condutores mantêm certo. Trânsito em direto medido por telemóveis na estrada, buracos e cortes confirmados pelos condutores que passam a seguir, e localizações, entradas e sentidos únicos corrigidos a partir das suas respostas.

Produtos

ProdutoO que fazEstado
SDK Maps para a webUm mapa interativo na sua página web, com o estilo do N-Ways e a sua chave1.0
SDK Maps para Android, para iOSMapas nativos na sua aplicação, com as mesmas chamadas de cliente1.0, a partir do código-fonte
API de MosaicosMosaicos vetoriais, tipos de letra e estilos alojados para os seus próprios mapasDisponível
Mapas estáticosUma imagem de mapa a partir de um endereço web, para e-mails, recibos e páginas de encomendaDisponível
GeocodificaçãoDe um endereço, de um código postal, de um endereço GhanaPost ou de um Plus Code para coordenadas, e vice-versaDisponível
Preenchimento automáticoSugestões enquanto se escreve um endereçoDisponível
Validação de endereçosVerificar e completar um endereço antes de enviar um estafetaDisponível
LugaresNegócios e lugares perto de um ponto, por categoria ou por nomeDisponível
PercursosPercursos para cada forma de se deslocar, com trânsito, portagens, proibições e fronteirasDisponível
Matriz de percursosOs tempos e as distâncias entre muitos pontos de recolha e de entrega de uma só vez, para o despachoDisponível
Otimização de percursosA melhor ordem para as entregas de um estafeta ou de uma pequena frotaDisponível
TarifasQuanto deve custar uma viagem de táxi, okada, keke, autocarro ou barcoDisponível
Trânsito, feed de trânsitoVelocidades e congestionamentos em diretoDisponível
Seguimento de frota, webhooksPosições dos estafetas em direto, horas de chegada das entregas, ligações de seguimento para os clientes, eventos enviados para o seu servidorDisponível
Pacotes offlineMapas e dados de estradas que as aplicações dos seus estafetas transferem com antecedênciaDisponível

Onde funciona

Na Nigéria, no Gana, no Benim, no Togo, no Gabão, na Costa do Marfim, na Libéria, na Guiné, na Serra Leoa, na Guiné-Bissau, no Senegal, nos Camarões, no Burkina Faso, em Cabo Verde e na Gâmbia, incluindo as estradas e os postos fronteiriços entre eles. As respostas vêm em inglês, francês (lang=fr) ou português (lang=pt), e os preços na moeda de cada país: naira (NGN), cedis ganeses (GHS), francos CFA da África Ocidental (XOF), francos CFA da África Central (XAF), dólares liberianos (LRD), francos guineenses (GNF), leones (SLE), escudos cabo-verdianos (CVE) e dalasis gambianos (GMD).

Códigos de casa

Cada lote destes 12 países tem um código de casa N-Ways: o nome do seu bairro ou aldeia e um número curto, como os que se seguem. A chamada de geocodificação aceita-os tal como se escrevem, e o guia de cada país cobre a consulta, o código de um ponto e a descodificação offline. Os códigos, o motor e um servidor pronto a usar estão abertos no GitHub, por isso também os pode alojar você mesmo.

Como funciona

  1. Obtenha uma chave. Registe-se na consola de parceiros com Google, Apple ou e-mail: indique o nome da sua empresa e a sua chave fica pronta, com os passos para a integrar. Primeiros passos
  2. Restrinja-a. Reserve a chave para o seu site, a sua aplicação Android ou iOS, ou os endereços IP dos seus servidores, e para as API que usa. Chaves de API e segurança
  3. Chame as API por HTTPS com key=A_SUA_CHAVE_API, ou mostre um mapa com o SDK Maps.
  4. Acompanhe a sua utilização por chave e por API, e defina os seus próprios limites. Quotas e limites
O seu primeiro pedido
curl "https://nways.ng/maps/v1/geocode?q=Allen+Avenue+Ikeja&limit=3&key=A_SUA_CHAVE_API"

Endereços e versões

As API respondem em https://nways.ng/maps/v1/…. A versão 1 só ganha coisas (novos pontos de acesso, parâmetros opcionais, campos nas respostas); uma alteração incompatível chegaria como /maps/v2, e a versão antiga seria mantida durante pelo menos 12 meses. Também respondem no seu próprio domínio, https://api.nways.ng/maps/v1/…. Os parceiros que começaram com os endereços antigos (https://nways.ng/v1/…) podem continuar a usá-los durante pelo menos 12 meses. Versões e alterações

Dúvidas

Escreva para hello@nways.ng a dizer-nos o que está a construir. Respondemos em inglês.