Cartes

Adresse de base : https://nways.ng/maps/v1

Un style de carte hébergé (un chargement de carte)

GET https://nways.ng/maps/v1/styles/{style}.json

Un style MapLibre pour le plan de rues N-Ways, avec la clé sur chaque URL N-Ways (tuiles, polices). Pointez MapLibre GL JS ou MapLibre Native dessus : style: 'https://nways.ng/maps/v1/styles/streets-light.json?key=nw_…'. Chaque lecture compte pour un chargement de carte (SKU map_loads, produit tiles). Les tuiles arrivent une par une (/tiles/base/{z}/{x}/{y}.mvt, tous les pays, avec des bounds qui les entourent tous), ou depuis l’archive PMTiles de chaque pays avec format=pmtiles (il faut le protocole pmtiles, que le SDK web enregistre) : le style a alors une source par pays (nways-ng, nways-gh, …) et chaque couche une fois par pays (roads-ng, roads-gh, …). Raisons : STYLE_NOT_FOUND, LANG_INVALID, FORMAT_INVALID.

Paramètres

curl "https://nways.ng/maps/v1/styles/streets-light.json" \
  -H "X-NWays-Api-Key: VOTRE_CLE_API"

const res = await fetch('https://nways.ng/maps/v1/styles/streets-light.json', {
  headers: { 'X-NWays-Api-Key': process.env.NWAYS_API_KEY },
})
const data = await res.json()

import os
import requests

res = requests.get(
    "https://nways.ng/maps/v1/styles/streets-light.json",
    headers={"X-NWays-Api-Key": os.environ["NWAYS_API_KEY"]},
    timeout=10,
)
data = res.json()

Réponse

Un style MapLibre (version 8)

{}

Erreurs

• default Erreur

Les archives de tuiles de chaque pays

GET https://nways.ng/maps/v1/tiles/countries.json

Les pays que N-Ways cartographie aujourd’hui, chacun avec son code ISO, son cadre (bbox : ouest, sud, est, nord), son contour (coordonnées GeoJSON MultiPolygon) et ses archives PMTiles (files.base, files.detail, files.transit ; un type peut manquer pendant qu’un pays est en construction). Lisez une tuile dans l’archive du pays dont le contour contient le centre de la tuile, puis dans toute autre dont le cadre la touche. Seules les archives listées ici sont servies (tout autre nom donne TILESET_NOT_FOUND) : relisez la liste plutôt que de garder les noms de fichiers. Gratuit avec toute clé Maps (compté, jamais facturé). TILES_UNAVAILABLE quand le serveur n’a pas de données cartographiques.

curl "https://nways.ng/maps/v1/tiles/countries.json" \
  -H "X-NWays-Api-Key: VOTRE_CLE_API"

const res = await fetch('https://nways.ng/maps/v1/tiles/countries.json', {
  headers: { 'X-NWays-Api-Key': process.env.NWAYS_API_KEY },
})
const data = await res.json()

import os
import requests

res = requests.get(
    "https://nways.ng/maps/v1/tiles/countries.json",
    headers={"X-NWays-Api-Key": os.environ["NWAYS_API_KEY"]},
    timeout=10,
)
data = res.json()

Réponse

La liste

[
  {
    "name": "togo",
    "country": "TG",
    "detail": "cities",
    "bbox": [
      0
    ],
    "files": {
      "base": "togo.pmtiles",
      "detail": "togo-detail.pmtiles",
      "transit": "togo-transit.pmtiles"
    },
    "outline": [
      [
        "string"
      ]
    ]
  }
]

Erreurs

• default Erreur

Lire l’archive PMTiles d’un pays (requêtes par plages)

GET https://nways.ng/maps/v1/tiles/{tileset}.pmtiles

Les tuiles vectorielles d’un pays en une archive PMTiles v3 : <country>.pmtiles (schéma de fond de carte Protomaps, zoom 0–15), <country>-detail.pmtiles (zoom 12–16) ou <country>-transit.pmtiles (zoom 5–15), comme listées dans /tiles/countries.json, lue par morceaux avec Range: bytes=a-b (8 Mo au plus par lecture ; l’archive entière n’est jamais servie). La clé est vérifiée à la première lecture d’une session d’archive depuis un site (toutes archives confondues) et comptée comme un appel tiles ; les lectures suivantes dans les 2 minutes profitent de cette vérification. Raisons : TILESET_NOT_FOUND, RANGE_REQUIRED, RANGE_TOO_LARGE, TILES_UNAVAILABLE.

Paramètres

curl "https://nways.ng/maps/v1/tiles/COUNTRY.pmtiles" \
  -H "X-NWays-Api-Key: VOTRE_CLE_API"

const res = await fetch('https://nways.ng/maps/v1/tiles/COUNTRY.pmtiles', {
  headers: { 'X-NWays-Api-Key': process.env.NWAYS_API_KEY },
})
const data = await res.json()

import os
import requests

res = requests.get(
    "https://nways.ng/maps/v1/tiles/COUNTRY.pmtiles",
    headers={"X-NWays-Api-Key": os.environ["NWAYS_API_KEY"]},
    timeout=10,
)
data = res.json()

Réponse

Les octets demandés

Erreurs

• default Erreur

Une tuile vectorielle

GET https://nways.ng/maps/v1/tiles/{tileset}/{z}/{x}/{y}.mvt

Une tuile Mapbox Vector Tile (un appel tiles) tirée de l’archive du pays où elle se trouve, si bien que chaque pays est dans chaque jeu de tuiles : base (zoom 0–15), detail (12–16) ou transit (5–15). Compressée en gzip quand le client l’accepte. 204 là où il n’y a pas de tuile (pleine mer). Au-delà du zoom maximal, surzoom (la source du style indique maxzoom: 15). Raisons : TILESET_NOT_FOUND, TILE_INVALID, TILE_NOT_FOUND, TILES_UNAVAILABLE.

Paramètres

curl "https://nways.ng/maps/v1/tiles/base/0/0/0.mvt" \
  -H "X-NWays-Api-Key: VOTRE_CLE_API"

const res = await fetch('https://nways.ng/maps/v1/tiles/base/0/0/0.mvt', {
  headers: { 'X-NWays-Api-Key': process.env.NWAYS_API_KEY },
})
const data = await res.json()

import os
import requests

res = requests.get(
    "https://nways.ng/maps/v1/tiles/base/0/0/0.mvt",
    headers={"X-NWays-Api-Key": os.environ["NWAYS_API_KEY"]},
    timeout=10,
)
data = res.json()

Réponse

Une tuile

Erreurs

• default Erreur

Glyphes de police pour les libellés de la carte (gratuit)

GET https://nways.ng/maps/v1/fonts/{stack}/{range}.pbf

Plages de glyphes pour les polices du style (Inter-Regular, Inter-Medium, Inter-SemiBold, Inter-Bold, Inter-Italic). Comptées, jamais facturées. Raisons : FONT_RANGE_INVALID, FONT_NOT_FOUND.

Paramètres

curl "https://nways.ng/maps/v1/fonts/Inter-Medium/0-255.pbf" \
  -H "X-NWays-Api-Key: VOTRE_CLE_API"

const res = await fetch('https://nways.ng/maps/v1/fonts/Inter-Medium/0-255.pbf', {
  headers: { 'X-NWays-Api-Key': process.env.NWAYS_API_KEY },
})
const data = await res.json()

import os
import requests

res = requests.get(
    "https://nways.ng/maps/v1/fonts/Inter-Medium/0-255.pbf",
    headers={"X-NWays-Api-Key": os.environ["NWAYS_API_KEY"]},
    timeout=10,
)
data = res.json()

Réponse

Glyphes

Erreurs

• default Erreur

Une image de carte

GET https://nways.ng/maps/v1/staticmap

Un PNG ou un JPEG de la carte, dessiné par N-Ways à partir de ses propres tuiles, avec des marqueurs et des tracés. Donnez center et zoom, ou seulement des marqueurs et des tracés pour les cadrer. Un appel static_maps.

URL signées. Ajoutez signature= (en dernier) pour utiliser une URL n’importe où (un e-mail, une application sans Referer), quelle que soit la restriction d’application de la clé : le HMAC-SHA256 en base64url du chemin et de la requête de l’URL (à partir de /maps/v1/staticmap?, sans signature), calculé avec le secret de signature de la clé (en base64url ; N-Ways vous le remet avec la clé). Une URL modifiée ou une signature fausse : 403 SIGNATURE_INVALID.

Raisons : SIZE_INVALID, SCALE_INVALID, THEME_INVALID, FORMAT_INVALID, MARKERS_INVALID, PATH_INVALID, CENTER_REQUIRED, CENTER_INVALID, ZOOM_INVALID, URL_TOO_LONG, SIGNATURE_INVALID.

Paramètres

curl "https://nways.ng/maps/v1/staticmap" \
  -H "X-NWays-Api-Key: VOTRE_CLE_API"

const res = await fetch('https://nways.ng/maps/v1/staticmap', {
  headers: { 'X-NWays-Api-Key': process.env.NWAYS_API_KEY },
})
const data = await res.json()

import os
import requests

res = requests.get(
    "https://nways.ng/maps/v1/staticmap",
    headers={"X-NWays-Api-Key": os.environ["NWAYS_API_KEY"]},
    timeout=10,
)
data = res.json()

Réponse

L’image

Erreurs

• default Erreur