Μετάβαση στο περιεχόμενο
GET /v1/nearby

Cities near a coordinate (radius search)

Δοκιμάστε το ζωντανά

10 δωρεάν κλήσεις την ημέρα — χωρίς εγγραφή, χωρίς κλειδί API. Μέσω του gateway του oanor.

Προσαρμοσμένες κεφαλίδες (προαιρετικά)
api.oanor.com/cities-api

Δουλεύει. Πάρε ένα κλειδί API και χρησιμοποίησέ το στο έργο σου.

Λάβετε ένα κλειδί API

Αποσπάσματα κώδικα

curl "https://api.oanor.com/cities-api/v1/nearby" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/cities-api/v1/nearby", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/cities-api/v1/nearby");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/cities-api/v1/nearby",
    headers={"x-oanor-key": "oanor_test_..."}
)

Παράδειγμα απόκρισης

Πραγματική απόκριση αυτού του endpoint, από τον τελευταίο έλεγχο υγείας.

{
    "data": {
        "count": 20,
        "center": {
            "lat": 48.8566,
            "lon": 2.3522
        },
        "results": [
            {
                "id": 3013131,
                "name": "Paris 04 Hôtel-de-Ville",
                "ascii": "Paris 04 Hotel-de-Ville",
                "admin1": "11",
                "country": "FR",
                "latitude": 48.8601,
                "timezone": "Europe/Paris",
                "longitude": 2.3507,
                "population": 27332,
                "distance_km": 0.4,
                "elevation_m": null,
                "country_name": "France"
            },
            {
                "id": 2988507,
                "name": "Paris",
                "ascii": "Paris",
                "admin1": "11",
                "country": "FR",
                "latitude": 48.85341,
                "timezone": "Europe/Paris",
                "longitude": 2.3488,
                "population": 2138551,
                "distance_km": 0.43,
                "elevation_m": null,
                "country_name": "France"
            },
            {
                "id": 6269531,
                "name": "Paris 01 Louvre",
                "ascii": "Paris 01 Louvre",
                "admin1": "11",
                "country": "FR",
                "latitude": 48.8592,
                "timezone": "Europe/Paris",
                "longitude": 2.3417,
                "population": 15114,
                "distance_km": 0.82,
                "elevation_m": null,
                "country_name": "France"
            },
            {
                "id": 2973189,
                "name": "Paris 03 Temple",
                "ascii": "Paris 03 Temple",
                "admin1": "11",
                "country": "FR",
                "latitude": 48.8637,
                "timezone": "Europe/Paris",
                "longitude": 2.3615,
                "population": 32179,
                "distance_km": 1.04,
                "elevation_m": null,
                "country_name": "France"
            },
            {
                "id": 3030864,
                "name": "Paris 02 Bourse",
                "ascii": "Paris 02 Bourse",
                "admin1": "11",
                "country": "FR",
                "latitude": 48.8655,
                "timezone": "Europe/Paris",
                "longitude": 2.3426,
                "population": 19847,
                "distance_km": 1.21,
                "elevation_m": null,
                "country_name": "France"
            },
            {
                "id": 2988623,
                "name": "Paris 05 Panthéon",
                "ascii": "Paris 05 Pantheon",
                "admin1": "11",
                "country": "FR",
                "latitude": 48.8448,
                "timezone": "Europe/Paris",
                "longitude": 2.3471,
                "population": 55252,
                "distance_km": 1.36,
                "elevation_m": null,
                "co
…