← Géo et météo

Recherche de géocodage

GET /geocoding/search

Convertissez les noms de lieux, addresses, ou location descriptions en geographic coordonnées (latitude et longitude). Renvoie matching locations avec leur names, countries, coordonnées, elevation, population, et timezone. Prend en charge fuzzy matching et renvoie plusieurs results ranked by relevance. Données de Open-Meteo geocoding propulsé par le GeoNames database. Essentiel pour les tout app qui needs to convertir user-typed locations en coordonnées pour use avec weather, map, ou other location-based APIs.

Paramètres

q requis

Place name or address to search

count optionnel par défaut: 10

Number of results (max 50)

Exemples de requêtes

Utilisation de base
curl "https://nordapi.ee/api/v1/geocoding/search?q=Oslo"
Search for Oslo
curl "https://nordapi.ee/api/v1/geocoding/search?q=Oslo"
Search for New York with more results
curl "https://nordapi.ee/api/v1/geocoding/search?q=New+York&count=20"
Search for Tokyo
curl "https://nordapi.ee/api/v1/geocoding/search?q=Tokyo"

Réponse en direct

{
  "count": 10,
  "data": [
    {
      "admin1": "Oslo County",
      "admin2": "Oslo",
      "country": "Norway",
      "country_code": "NO",
      "elevation": 26.0,
      "latitude": 59.91273,
      "longitude": 10.74609,
      "name": "Oslo",
      "population": 1082575,
      "timezone": "Europe/Oslo"
    },
    {
      "admin1": "Minnesota",
      "admin2": "Marshall",
      "country": "United States",
      "country_code": "US",
      "elevation": 246.0,
      "latitude": 48.19526,
      "longitude": -97.13202,
      "name": "Oslo",
      "population": 320,
      "timezone": "America/Chicago"
    },
    {
      "admin1": "Florida",
      "admin2": "Indian River",
      "country": "United States",
      "country_code": "US",
      "elevation": 4.0,
      "latitude": 27.5867,
      "longitude": -80.38033,
      "name": "Oslo",
      "population": null,
      "timezone": "America/New_York"
    },
    {
      "admin1": "Minnesota",
      "admin2": "Dodge",
      "country": "United States",
      "country_code": "US",
      "elevation": 395.0,
      "latitude": 43.89219,
      "longitude": -92.73852,
      "name": "Oslo",
      "population": null,
      "timezone": "America/Chicago"
    },
    {
      "admin1": "Junin",
      "admin2": "Jauja Province",
      "country": "Peru",
      "country_code": "PE",
      "elevation": 4487.0,
      "latitude": -11.78219,
      "longitude": -75.24206,
      "name": "Oslo",
      "population": null,
      "timezone": "America/Lima"
    },
    {
      "admin1": "Shiselweni District",
      "admin2": null,
      "country": "Eswatini",
      "country_code": "SZ",
      "elevation": 348.0,
      "latitude": -27.23889,
      "longitude": 31.64507,
      "name": "Oslo",
      "population": null,
      "timezone": "Africa/Mbabane"
    },
    {
      "admin1": "Central Visayas",
      "admin2": "Province of Cebu",
      "country": "Philippines",
      "country_code": "PH",
      "elevation": 7.0,
      "latitude": 9.5211,
      "longitude": 123.4315,
      "name": "Oslob",
      "population": 3724,
      "timezone": "Asia/Manila"
    },
    {
      "admin1": "Bourgogne-Franche-Comté",
      "admin2": "Saône-et-Loire",
      "country": "France",
      "country_code": "FR",
      "elevation": 188.0,
      "latitude": 46.78369,
      "longitude": 4.92336,
      "name": "Oslon",
      "population": 995,
      "timezone": "Europe/Paris"
    },
    {
      "admin1": "Lower Saxony",
      "admin2": null,
      "country": "Germany",
      "country_code": "DE",
      "elevation": 57.0,
      "latitude": 52.46925,
      "longitude": 10.68011,
      "name": "Osloß",
      "population": 1990,
      "timezone": "Europe/Berlin"
    },
    {
      "admin1": "Jihočeský kraj",
      "admin2": "Písek District",
      "country": "Czechia",
      "country_code": "CZ",
      "elevation": 419.0,
      "latitude": 49.39926,
      "longitude": 14.21196,
      "name": "Oslov",
      "population": 334,
      "timezone": "Europe/Prague"
    }
  ],
  "success": true
}