Watch-IP

Besucher-Geolokalisierung für Ihre Website

Rufen Sie GET /v1/geo direkt aus dem Browser eines Besuchers auf, um das verfügbare Land, die Stadt, die Zeitzone und den regionalen Kontext dieser Verbindung zu erhalten. Konfigurieren Sie Ihren erlaubten Origin, fügen Sie Ihren veröffentlichbaren Schlüssel hinzu und entscheiden Sie, wie Ihre Anwendung mit der Antwort umgehen soll.

Kostenlosen Besucher-API-Schlüssel holenDen Schnellstart lesen →

Die Anfrage kommt aus dem Browser des Besuchers

GET /v1/geo beschreibt immer den jeweils verbindenden Client. Rufen Sie es aus dem Browser des Besuchers auf, um die Standortdaten dieser Verbindung zu erhalten; eine von Ihrem Anwendungsserver gesendete Anfrage beschreibt die eigene Verbindung des Servers, nicht die des Besuchers. Wenn Sie bereits die IP-Adresse eines Endnutzers haben und diese stattdessen in Ihrem Backend auflösen möchten, verwenden Sie die separate IP-Abfrage-API. Der Besucher-Schlüssel ist veröffentlichbar — er ist dafür ausgelegt, im Browser-Code zu erscheinen —, sodass die eigentliche Kontrolle die für ihn konfigurierte Liste erlaubter Origins ist, nicht die Geheimhaltung des Schlüssels selbst.

Als Vorschlag gestalten, nicht als erzwungene Weiterleitung

Ein Reisender nutzt möglicherweise ein Netzwerk in einem Land, bevorzugt aber eine andere Sprache, und ein VPN kann eine Verbindung an einen ganz anderen Ort verlegen. Geben Sie Besuchern eine sichtbare Möglichkeit, die vorgeschlagene Sprache, das Land oder die Währung zu ändern, und bewahren Sie diese Wahl, statt sie bei jedem Besuch erneut aus dem Standort abzuleiten.

Sicherheitskontext nur bei berechtigten Tarifen

Bei Tarifen, die dies enthalten, kann die Antwort listenbasierte VPN-/Tor-/Bedrohungsindikatoren enthalten. Ein fehlendes security-Objekt bedeutet, dass das Feld in Ihrem Tarif nicht enthalten ist, nicht dass das Netzwerk als sicher befunden wurde; ein false-Wert bedeutet keine Übereinstimmung in den verfügbaren Quelldaten, was nicht dasselbe ist wie ein sauberer Befund. Die Abdeckung unterscheidet sich je nach Indikator und IP-Version — die IPv6-Tor-Erkennung ist beispielsweise derzeit nicht implementiert.

Nützlicher Kontext in der Antwort

country, region, city, latitude, longitude
Ungefährer Standort für die verbindende Anfrage. Keine Geräte- oder GPS-Position und kein Beleg für den Aufenthaltsort einer bestimmten Person.
timezone, currency, callingCode
Regionaler Kontext, abgeleitet aus dem ermittelten Standort — als Ausgangsvorschlag nützlich.
asn, asOrganization
Das verbindende Netzwerk und dessen Betreiber, sofern verfügbar. Ein Organisationsname ist keine Identität einer Person.
security
Vollständig ausgelassen, sofern Ihr Tarif es nicht enthält. Falls vorhanden: isVpn, isTor, isDatacenter, isThreat, isSanctionedNetwork — listenbasierte Indikatoren, keine Sicherheitsgarantie.

Die erste Anfrage hinzufügen

Browser-JavaScript

async function loadVisitorLocation() {
  const response = await fetch('https://api.watch-ip.com/v1/geo', {
    headers: { 'X-Api-Key': 'YOUR_PUBLISHABLE_KEY' },
  });

  if (!response.ok) {
    throw new Error(`Visitor geolocation failed (${response.status})`);
  }

  const geo = await response.json();
  return { country: geo.country ?? null, city: geo.city ?? null, timezone: geo.timezone ?? null };
}

Ersetzen Sie den Platzhalter durch Ihren Besucher-Schlüssel, und führen Sie die Seite von einem für diesen Schlüssel erlaubten Origin aus. Halten Sie das Standarderlebnis Ihrer Website verfügbar, falls die Anfrage fehlschlägt oder ein Feld fehlt.

Häufig gestellte Fragen

Fordert dies eine Geräte-Standortberechtigung an?

Nein. Die IP-basierte Anfrage nutzt nicht die Geräte-Geolocation-API des Browsers — sie schätzt den Standort anhand der Verbindung, statt gerätebasierte Koordinaten anzufordern. Ihre eigenen Datenschutz- und Einwilligungspflichten hängen weiterhin davon ab, wie Ihre Anwendung das Ergebnis verwendet.

Kann ich eine IP-Adresse an /v1/geo übergeben?

Nein. Der Endpoint beschreibt immer den verbindenden Client. Verwenden Sie /v1/lookup/{ip} aus Ihrem Backend, wenn Sie eine Adresse angeben möchten.

Warum zeigt eine serverseitig gerenderte Anfrage den Standort meines Hosting-Anbieters?

Der Server ist für diese Anfrage der verbindende Client. Verlagern Sie die Besucher-Anfrage in Browser-Code, oder verwenden Sie den IP-Abfrage-Endpoint aus Ihrem Backend mit einer vertrauenswürdigen Quelle für die IP des Endnutzers.

Ist die Stadt oder die Koordinate exakt?

Nein. IP-Geolokalisierung ist eine mit der Verbindung verknüpfte Schätzung, keine präzise Position einer Person.

Kann ich einen geheimen Schlüssel im Browser verwenden?

Nein. Verwenden Sie für diesen Endpoint einen veröffentlichbaren Besucher-Schlüssel, und bewahren Sie geheime Abfrage-Schlüssel ausschließlich in Ihrer Backend-Umgebung auf.

Verwandte Seiten