Recherche et lieux

Commerces et lieux autour d’un point : stations-service, agents POS et distributeurs qui donnent de l’argent, pharmacies, gares routières, restaurants, avec horaires, téléphones et notes quand les gens les ont donnés.

Sur cette page

Lieux autour d’un point
Lieux par texte
Champs et paliers de prix
Catégories
Détails d’un lieu
D’où viennent les données
L’ancienne adresse

Adresse de base : https://nways.ng/maps/v1. Trois façons d’entrer : les lieux autour d’un point, par catégorie ou par nom ; les lieux par texte ; et les détails d’un lieu. Référence

Lieux autour d’un point

GET /maps/v1/places/nearby

Paramètre	Description
`lat`, `lng`	Obligatoires. Le point autour duquel chercher.
`category`	Une des catégories. Avec une catégorie, les résultats sont classés par proximité et par importance, 40 par page ; les listes de distributeurs et d’espèces placent d’abord les appareils qui donnent de l’argent.
`q`	Un nom à chercher, jusqu’à 60 caractères : Total, Medplus. Donnez une catégorie, un nom ou les deux.
`radius`	En mètres, de 200 à 50 000.
`limit`, `pageToken`	Jusqu’à 40 par page ; le `nextPageToken` de la réponse donne la page suivante.
`fields`	Les champs que vous voulez : ils fixent le palier de prix.

cURL

curl "https://nways.ng/maps/v1/places/nearby?lat=6.6018&lng=3.3515&category=pharmacy&radius=1500" \
  -H "X-NWays-Api-Key: VOTRE_CLE_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"
}

Lieux par texte

GET /maps/v1/places/search?q=… pour « Zenith Bank Ikeja » ou « pharmacy near Yaba » : il comprend une catégorie dans un lieu. Ajoutez near (lat,lng) et radius pour chercher autour d’un point, country pour rester dans un pays, et limit (jusqu’à 20).

cURL

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

Champs et paliers de prix

Ne demandez que ce que vous affichez : les champs fixent le coût d’un appel. Tarifs

Palier	Champs
Basic (par défaut)	`id`, `name`, `category`, `location`, `formattedAddress`, `plusCode`, `country`, `distanceM`, `businessStatus`, `attribution`
Contact	Basic, plus `phone`, `email`, `website`, `openingHours` (avec l’origine des horaires et le nombre de personnes qui les ont confirmés)
Atmosphere	Contact, plus `rating`, `amenities` et `details` (prix du carburant, si un POS a des espèces, les équipements d’un hôtel…)

Un seul champ d’un palier place l’appel dans ce palier : fields=name,location,phone est un appel Contact.

Catégories

Groupe	Catégories
Sur la route	`petrol`, `charging`, `mechanic`, `vulcanizer`, `carwash`, `parking`, `motorpark`, `police`
Argent	`bank`, `atm` (banques et distributeurs, ceux qui donnent de l’argent d’abord), `pos`, `cash` (distributeurs et agents POS, ceux qui donnent de l’argent d’abord)
Manger et boire	`food`, `fastfood`, `cafe`, `bar`
Santé	`hospital`, `pharmacy`
Achats	`supermarket`, `shop`, `market`, `phones`, `salon`
Lieux	`hotel`, `church`, `mosque`, `school`, `university`, `office`, `government`, `attraction`, `estate`, `residential`

Détails d’un lieu

GET /maps/v1/places/{id}?fields=… : un lieu, par l’id d’une liste ou le placeId d’un résultat de géocodage. fields est obligatoire ici (ou * pour tout, un appel Atmosphere).

cURL

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

D’où viennent les données

D’OpenStreetMap, des lieux de l’Overture Maps Foundation, et de ce que les utilisateurs de N-Ways ajoutent, confirment et corrigent. Si vous affichez des lieux venant de N-Ways, affichez l’attribution et les crédits indiqués dans Attribution et conditions.

L’ancienne adresse

https://nways.ng/v1/places continue de fonctionner pour les partenaires qui l’utilisent déjà pendant au moins 12 mois, mais sa réponse suit l’application N-Ways. Passez à /maps/v1/places/….