Preenchimento automático

Sugestões enquanto se escreve: ruas, pontos de referência, empresas, códigos NIPOST e GhanaPost, os mais próximos primeiro.

Nesta página

O mais rápido: a caixa de pesquisa
A API
Sessões e faturação

Sugestões enquanto se escreve um endereço: ruas, empresas, pontos de referência, bairros, códigos postais NIPOST e códigos GhanaPost GPS, os mais próximos primeiro. Feito para campos de endereço de entrega e para a pesquisa do ponto de recolha.

O mais rápido: a caixa de pesquisa

Numa página web, a caixa de pesquisa do SDK Maps trata de tudo: sugestões, teclado, leitores de ecrã e sessões.

JavaScript

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

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

A API

cURL

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

Parâmetro	Descrição
`q`	Obrigatório. O que foi escrito até agora.
`session`	O token de sessão da pesquisa: de 8 a 64 letras, algarismos, `-` ou `_` (um UUID serve). O mesmo em todos os pedidos, até a pessoa escolher uma sugestão.
`near`	`lat,lng`: ordena as sugestões perto deste ponto (a pessoa, ou o centro do mapa).
`country`	`NG`, `GH`, `BJ`, `TG`, `GA`, `CI`, `LR`, `GN`, `SL`, `GW`, `SN`, `CM`, `BF`, `CV`, ou vários, separados por vírgulas.
`types`	Apenas alguns tipos: `address`, `street`, `business`, `place`, `area`, `postcode`, `ghanapost`.
`limit`	Até 10 sugestões; 5 por omissão.
`lang`	`en` ou `fr`.

A resposta contém results, com a mesma forma que a da geocodificação: name, formattedAddress, location e, quando existe, o código postcode ou ghanaPost. Referência

Sessões e faturação

Uma pessoa que escreve «Allen Avenue» envia uma dúzia de pedidos. Com um token de sessão, formam uma só sessão: o primeiro pedido é faturado, o resto da sessão não. Use um token novo depois de cada escolha (ou quando o campo é limpo). Sem token, cada pedido é faturado como uma sessão própria. O cabeçalho X-NWays-Session-Billed da resposta indica se este pedido foi o faturado.

Dica:

Espere cerca de 200 milissegundos depois da última tecla antes de pedir, e não peça nada para uma ou duas letras: menos pedidos, e sugestões melhores.