Geo-API

country_code/country_name, is_eu, continent/continent_code, region/region_code, city, postal_code, latitude, longitude. timezone als IANA-Zone plus ein time_zone-Objekt mit id, utc_offset (z. B. +02:00), utc_offset_seconds, is_dst (Sommerzeit-Flag) und current_time (aktuelle Ortszeit als ISO-8601). Liefert die City-Ebene keine Zone, aber das Land hat nur eine, ergänzt timezone die primäre Landeszone; Mehrzeitzonen-Länder (US, Russland, …) bleiben bewusst null statt eine pauschale Zone zu erfinden.

Je erkanntem Land calling_code (Telefon-Vorwahl als Ganzzahl, z. B. 49), currency als Objekt aus code und symbol (z. B. EUR / €) und languages als Array der Amts- und Verkehrssprachen im ISO-639-1-Format. Diese Felder leiten sich aus dem Ländercode ab und ersparen eine zweite Nachschlagetabelle.

network ist der gematchte Netzbereich als IPv4-CIDR (z. B. 8.8.8.0/24), rir die zuständige Regional Internet Registry (RIPE, ARIN, APNIC, LACNIC, AFRINIC). asn, isp und isp_domain benennen den Netzbetreiber. Aus dem RIR-Register stammen zusätzlich org_id (Org-Handle zum Gruppieren aller Netze einer Firma), org_type (z. B. LIR oder Endkunde), registry_country (Land des Betreibers laut Register), allocation_date (Erstregistrierung der ASN — ein sehr junges Netz kann ein Risiko-Signal sein) und abuse_contact (Abuse-E-Mail des Betreibers für Missbrauchsmeldungen).

Pro IP Flags für Hosting (is_hosting), Rechenzentrum (is_datacenter), VPN (is_vpn), Tor (is_tor), Satellit (is_satellite), Anycast/Resolver (is_anycast), iCloud Private Relay (is_relay) und Bogon (is_bogon), dazu cloud_provider (erkennt bekannte Cloud-ASNs wie AWS, Google Cloud, Azure; sonst null) und ein abgeleiteter connection_type (hosting, satellite, relay oder isp). Daraus wird ein abuse_score von 0 bis 100 errechnet — Tor (+40), VPN (+30), Hosting (+20) und Anycast ohne bekannten Public-Resolver (+10) summieren sich; ein Treffer in der Spamhaus-DROP-Liste hebt den Score auf mindestens 90. risk gruppiert den Score grob: niedrig (unter 20), erhöht (unter 50), hoch (ab 50). Das risk-Label wird unabhängig von lang immer deutsch zurückgegeben. Konnten die Reputationslagen nicht gelesen werden, liefert die API abuse_score und risk als null statt einer Bestnote. Alle Flags und der Score sind Schätzwerte auf Basis bekannter IP-Bereiche — keine garantierte Aussage.

Statt eine Punkt-Genauigkeit vorzutäuschen, liefert jede Antwort accuracy_radius_km (geschätzter Radius in km um die Koordinaten) und confidence je Feld (country, region, city als 0–100). Der Radius richtet sich nach der erreichten Granularität: stadtgenau aus einer Operator-/Geofeed-Quelle rund 25 km (iCloud-Relay-Standorte gröber, rund 80 km), aus der City-DB rund 50 km, nur regionsgenau 150 km, nur landesgenau 600 km. Beides sind offene Schätzwerte — keine zugesicherte Präzision. Kennt die offene Ortsdatenbank für einen Adressbereich nur einen Ersatzort (etwa den Sitz des Netzbetreibers, bei dem sich Zugänge aus dem ganzen Land sammeln), bleiben Stadt und Region leer und der Radius beträgt 600 km — lieber keine Angabe als eine falsche. Meldet der Netzbetreiber den Ort selbst per Geofeed, gilt seine Angabe.