Saisie semi-automatique

Des suggestions pendant la saisie : rues, repères, commerces, codes NIPOST et GhanaPost, les plus proches d’abord.

Sur cette page

Le plus rapide : le champ de recherche
L’API
Sessions et facturation

Des suggestions pendant qu’on tape une adresse : rues, commerces, points de repère, quartiers, codes postaux NIPOST et codes GhanaPost GPS, les plus proches d’abord. Conçue pour les champs d’adresse de livraison et la recherche du point d’enlèvement.

Le plus rapide : le champ de recherche

Dans une page web, le champ de recherche du SDK Maps fait tout : suggestions, clavier, lecteurs d’écran et sessions.

JavaScript

import { attachAutocomplete } from 'https://nways.ng/sdk/v1/nways-maps.standalone.js'

attachAutocomplete(document.querySelector('#address'), {
  key: 'VOTRE_CLE_API',
  near: { lat: 6.5244, lng: 3.3792 },
  country: 'NG',
  onSelect: (place) => console.log(place.name, place.location.coordinates),
})

L’API

cURL

curl "https://nways.ng/maps/v1/autocomplete?q=allen%20av&near=6.60,3.35&session=4f1c2a9e-7d3b-4e55-9a51-0c8e2b7f6d10&key=VOTRE_CLE_API"

Paramètre	Description
`q`	Obligatoire. Ce qui a été tapé jusqu’ici.
`session`	Le jeton de session de la recherche : de 8 à 64 lettres, chiffres, `-` ou `_` (un UUID convient). Le même sur chaque requête, jusqu’à ce que la personne choisisse une suggestion.
`near`	`lat,lng` : classe les suggestions autour de ce point (la personne, ou le centre de la carte).
`country`	`NG`, `GH`, `BJ`, `TG`, `GA`, `CI`, `LR`, `GN`, `SL`, `GW`, `SN`, `CM`, `BF`, `CV`, ou plusieurs, séparés par des virgules.
`types`	Seulement certaines sortes : `address`, `street`, `business`, `place`, `area`, `postcode`, `ghanapost`.
`limit`	Jusqu’à 10 suggestions ; 5 par défaut.
`lang`	`en` ou `fr`.

La réponse contient results, sous la même forme que celle du géocodage : name, formattedAddress, location et, quand il y en a un, le code postcode ou ghanaPost. Référence

Sessions et facturation

Une personne qui tape « Allen Avenue » envoie une douzaine de requêtes. Avec un jeton de session, elles forment une seule session : la première requête est facturée, le reste de la session ne l’est pas. Prenez un nouveau jeton après chaque choix (ou quand le champ est vidé). Sans jeton, chaque requête est facturée comme une session à part entière. L’en-tête X-NWays-Session-Billed de la réponse indique si cette requête était celle qui a été facturée.

Astuce :

Attendez environ 200 millisecondes après la dernière touche avant de demander, et ne demandez rien pour une ou deux lettres : moins de requêtes, et de meilleures suggestions.