Pesquisa e lugares

Empresas e lugares perto de um ponto: postos de combustível, agentes POS e multibancos que dão dinheiro, farmácias, estações rodoviárias, restaurantes, com horários, telefones e classificações quando as pessoas os deram.

Nesta página

Lugares perto de um ponto
Lugares por texto
Campos e escalões de preço
Categorias
Detalhes de um lugar
De onde vêm os dados
O endereço antigo

Endereço base: https://nways.ng/maps/v1. Três formas de entrar: lugares perto de um ponto, por categoria ou por nome; lugares por texto; e os detalhes de um lugar. Referência

Lugares perto de um ponto

GET /maps/v1/places/nearby

Parâmetro	Descrição
`lat`, `lng`	Obrigatórios. O ponto à volta do qual pesquisar.
`category`	Uma das categorias. Com uma categoria, os resultados são ordenados por proximidade e por importância, 40 por página; as listas de multibancos e de dinheiro põem primeiro as máquinas que dão dinheiro.
`q`	Um nome a procurar, até 60 caracteres: Total, Medplus. Indique uma categoria, um nome ou ambos.
`radius`	Em metros, de 200 a 50 000.
`limit`, `pageToken`	Até 40 por página; o `nextPageToken` da resposta dá a página seguinte.
`fields`	Os campos que quer: definem o escalão de preço.

cURL

curl "https://nways.ng/maps/v1/places/nearby?lat=6.6018&lng=3.3515&category=pharmacy&radius=1500" \
  -H "X-NWays-Api-Key: A_SUA_CHAVE_API"

JavaScript

import { createClient } from '@nways/maps'

const nways = createClient({ key: process.env.NWAYS_API_KEY })
const { places } = await nways.placesNearby({ lat: 6.6018, lng: 3.3515 }, { category: 'petrol', radius: 3000 })
for (const p of places) console.log(p.name, Math.round(p.distanceM), 'm')

200 OK

{
  "places": [
    {
      "id": "ov:860b85b1-e8dd-488d-bb83-e8e65a6965e1",
      "name": "Access Bank",
      "category": "bank",
      "location": { "type": "Point", "coordinates": [3.491648, 6.438141] },
      "formattedAddress": "999C Danmole Street, Victoria Island",
      "plusCode": "6FR5CFQR+7M2",
      "country": "NG",
      "distanceM": 2403,
      "businessStatus": "OPERATIONAL",
      "attribution": "© OpenStreetMap contributors, N-Ways"
    }
  ],
  "nextPageToken": "…",
  "attribution": "© OpenStreetMap contributors, N-Ways"
}

Lugares por texto

GET /maps/v1/places/search?q=… para «Zenith Bank Ikeja» ou «pharmacy near Yaba»: compreende uma categoria num lugar. Acrescente near (lat,lng) e radius para pesquisar à volta de um ponto, country para ficar num só país, e limit (até 20).

cURL

curl "https://nways.ng/maps/v1/places/search?q=pharmacy+Yaba&limit=5" -H "X-NWays-Api-Key: A_SUA_CHAVE_API"

Campos e escalões de preço

Peça só o que mostra: os campos definem o custo de uma chamada. Preços

Escalão	Campos
Basic (por omissão)	`id`, `name`, `category`, `location`, `formattedAddress`, `plusCode`, `country`, `distanceM`, `businessStatus`, `attribution`
Contact	Basic, mais `phone`, `email`, `website`, `openingHours` (com a origem dos horários e quantas pessoas os confirmaram)
Atmosphere	Contact, mais `rating`, `amenities` e `details` (preços do combustível, se um POS tem dinheiro, as comodidades de um hotel…)

Um só campo de um escalão põe a chamada nesse escalão: fields=name,location,phone é uma chamada Contact.

Categorias

Grupo	Categorias
Na estrada	`petrol`, `charging`, `mechanic`, `vulcanizer`, `carwash`, `parking`, `motorpark`, `police`
Dinheiro	`bank`, `atm` (bancos e multibancos, primeiro os que dão dinheiro), `pos`, `cash` (multibancos e agentes POS, primeiro os que dão dinheiro)
Comer e beber	`food`, `fastfood`, `cafe`, `bar`
Saúde	`hospital`, `pharmacy`
Compras	`supermarket`, `shop`, `market`, `phones`, `salon`
Lugares	`hotel`, `church`, `mosque`, `school`, `university`, `office`, `government`, `attraction`, `estate`, `residential`

Detalhes de um lugar

GET /maps/v1/places/{id}?fields=…: um lugar, pelo id de uma lista ou pelo placeId de um resultado de geocodificação. fields é obrigatório aqui (ou * para tudo, uma chamada Atmosphere).

cURL

curl "https://nways.ng/maps/v1/places/osm:n2987189855?fields=name,location,phone,openingHours" \
  -H "X-NWays-Api-Key: A_SUA_CHAVE_API"

De onde vêm os dados

Do OpenStreetMap, dos lugares da Overture Maps Foundation e do que os utilizadores do N-Ways acrescentam, confirmam e corrigem. Se mostrar lugares vindos do N-Ways, mostre a attribution e os créditos indicados em Atribuição e condições.

O endereço antigo

https://nways.ng/v1/places continua a funcionar para os parceiros que já o usam durante pelo menos 12 meses, mas a sua resposta acompanha a aplicação N-Ways. Passe para /maps/v1/places/….