Preenchimento automático

Sugestões enquanto se escreve, faturadas por sessão.

Nota:

Envie a sua chave com key=A_SUA_CHAVE_API no endereço, ou no cabeçalho X-NWays-Api-Key. Chaves de API

Endereço base: https://nways.ng/maps/v1

Sugestões à medida que se escreve (faturado por sessão)

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

Envie o mesmo token session (8–64 caracteres de A–Z a–z 0–9 - _, um UUID serve) desde a primeira letra até o utilizador escolher um resultado: o primeiro pedido da sessão é faturado (uma sessão autocomplete); os restantes contam para o limite de pedidos mas não são cobrados, até 3 minutos entre pedidos, 15 minutos e 100 pedidos no total. Comece um novo token depois de uma escolha. Sem token, cada pedido é uma sessão. X-NWays-Session-Billed: 1|0 indica qual. Motivos: os de /geocode, e SESSION_INVALID, TYPES_INVALID.

Parâmetros

Nome	Onde	Tipo	Descrição
`q`	consulta	`string`	Obrigatório.
`session`	consulta	`string`
`near`	consulta	`string`	lat,lng: ordenar e escolher resultados perto deste ponto.
`country`	consulta	`string`	Lista separada por vírgulas de NG, GH, BJ, TG, GA, CI, LR, GN, SL, GW, SN, CM, BF, CV, GM.
`types`	consulta	`string`	Lista separada por vírgulas de address, street, business, place, area, postcode, ghanapost.
`limit`	consulta	`integer`	Predefinição: `5`. ≥ 1, ≤ 10.
`lang`	consulta	`string`	Um de: `en`, `fr`, `pt`. Predefinição: `en`.
`fields`	consulta	`string`	Lista separada por vírgulas dos campos a manter em cada resultado (`a.b` entra em objetos; `id` é sempre mantido; `*` = todos).

cURL

curl "https://nways.ng/maps/v1/autocomplete?q=lekki+ph" \
  -H "X-NWays-Api-Key: A_SUA_CHAVE_API"

JavaScript

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

Python

import os
import requests

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

Resposta

Sugestões

Campo	Tipo	Descrição
`results`	`Result[]`	Obrigatório.
`results[].id`	`string`	Obrigatório.
`results[].name`	`string`	Obrigatório.
`results[].type`	`string`	Obrigatório. address, street, business, landmark, building, postcode, ghanapost, ou uma zona: neighbourhood, suburb, village, town, city, state…
`results[].category`	`string`
`results[].location`	`Point`	Obrigatório.
`results[].location.type`	`string`	Obrigatório.
`results[].location.coordinates`	`number[]`	Obrigatório. [lng, lat] Pelo menos 2 elementos, no máximo 2 elementos.
`results[].bbox`	`number[]`	oeste, sul, este, norte (zonas) Pelo menos 4 elementos, no máximo 4 elementos.
`results[].formattedAddress`	`string`
`results[].postcode`	`string`	Código postal NIPOST, compacto
`results[].ghanaPost`	`string`
`results[].plusCode`	`string`	Obrigatório.
`results[].country`	`string`
`results[].distanceM`	`number`	A partir de near (ou do ponto consultado).
`results[].estimated`	`boolean`	O ponto é uma estimativa, dentro de accuracyM.
`results[].accuracyM`	`number`
`results[].placeId`	`string`	Um negócio: o seu id para /places/{id}.
`results[].attribution`	`string`
`didYouMean`	`string`
`attribution`	`string`	Obrigatório.

200 OK

{
  "results": [
    {
      "id": "osm:w568367632",
      "name": "Ikeja City Mall",
      "type": "landmark",
      "category": "shopping",
      "location": {
        "type": "string",
        "coordinates": [
          0
        ]
      },
      "bbox": [
        0
      ],
      "formattedAddress": "Ikeja, Lagos",
      "postcode": "LA08A09DB09",
      "ghanaPost": "GA-183-8164",
      "plusCode": "6FR5J975+P4W",
      "country": "NG",
      "distanceM": 0,
      "estimated": true,
      "accuracyM": 0,
      "placeId": "string",
      "attribution": "string"
    }
  ],
  "didYouMean": "string",
  "attribution": "string"
}

Erros

default Erro