Erweiterte Antworten

Drei optionale Parameter ergänzen die Default-Antwort, ohne deren Performance zu verschlechtern: extended, flag, lang.

🎨 extended-Blöcke

Granular wählbar als kommagetrennte Liste oder Alias.

BlockWas er liefertLatenz-Δ
countryBlock country{}: Name, ISO3, Continent, Currency, Phone-Prefix, Postal-Format, Languages, Neighbours, Capital, Geonameid …1 Batch-Query · ~2 ms
adminBlöcke admin1{} (Bundesland) und admin2{} (Kreis/Bezirk) inkl. Namen.2 Batch-Queries · ~5 ms
timezoneBlock timezone_info{}: gmt_offset, dst_offset, raw_offset in Stunden.1 Batch-Query · ~1 ms
flagFeld flag_url: absolute URL zur SVG-Flagge.0 Queries · ~0 ms
localizedÜberschreibt name, country.name, admin1.name mit der lang-Variante. Setzt localized_lang.1 Batch-Query · ~3 ms
Aliase
1Legacy-Default: country,admin,timezone4 Batch-Queries · ~8 ms
allAlle Blöcke: country,admin,timezone,flag,localized5 Batch-Queries · ~11 ms
Backwards-Compat: Die Default-Antwort enthält die Blöcke nicht — bestehende Clients sehen keine Veränderung. Erweitern kannst du nach Bedarf, ohne dass alte Integrationen brechen.

🎨 Lokalisierung mit lang=…

Der lang-Parameter aktiviert automatisch den localized-Block. Default-Antworten haben oft englische Namen — mit lang=de bekommst du:

  • hit.name: München statt „Munich"
  • hit.country.name: Deutschland statt „Germany"
  • hit.admin1.name: Bayern statt „Bavaria"

Funktioniert für alle ~250 ISO-Sprachcodes, die in geo_alternate_names existieren (de, fr, es, it, pl, zh, ja, ar, …). Fehlende Übersetzung → englischer Default-Name als Fallback.

Beispiel:

GET /api/lookup.php?lat=48.137&lon=11.575&extended=all&lang=de

→ {
  "hit": {
    "name": "München",
    "country": { "name": "Deutschland", "currency_code": "EUR", … },
    "admin1":  { "name": "Bayern" },
    "admin2":  { "name": "Upper Bavaria" },
    "timezone_info": { "gmt_offset": 1.0, "dst_offset": 2.0, … },
    "flag_url": "https://geoapi.world/assets/Bilder/Flaggen/de.svg",
    "localized_lang": "de"
  }
}

🎨 Flaggen-URLs

extended=…,flag oder flag=1 ergänzt flag_url mit einer absoluten URL zur SVG-Flagge. 233 ISO-2-Codes haben Flaggen, ~17 haben keine (sehr exotische Territorien) — dort bekommst du null.

Siehe auch den Flag-Endpoint für direkte SVG-Auslieferung via 302-Redirect oder JSON.