Web siteniz için ziyaretçi konum tespiti

Bir ziyaretçinin tarayıcısından doğrudan GET /v1/geo'yu çağırarak o bağlantının mevcut ülke, şehir, saat dilimi ve bölgesel bağlamını alın. İzin verilen origin'inizi yapılandırın, yayınlanabilir anahtarınızı ekleyin ve uygulamanızın yanıtı nasıl işleyeceğine karar verin.

Ücretsiz ziyaretçi API anahtarı alın Hızlı başlangıcı okuyun →

İstek, ziyaretçinin tarayıcısından gelir

GET /v1/geo her zaman ona bağlanan istemciyi tanımlar. Bağlantının konum verisini almak için bunu ziyaretçinin tarayıcısından çağırın; uygulama sunucunuzdan gönderilen bir istek, ziyaretçinin değil sunucunun kendi bağlantısını tanımlar. Bir son kullanıcının IP adresi zaten elinizdeyse ve bunu sunucunuzda çözümlemeniz gerekiyorsa, ayrı IP sorgulama API'sini kullanın. Ziyaretçi anahtarı yayınlanabilirdir — tarayıcı kodunda görünmek üzere tasarlanmıştır — bu yüzden gerçek kontrol, anahtarın gizliliği değil, onun için yapılandırılmış izin verilen origin listesidir.

Zorunlu bir yönlendirme değil, bir öneri için tasarlayın

Bir gezgin bir ülkedeki ağı kullanırken başka bir dili tercih edebilir ve bir VPN bağlantıyı tamamen farklı bir yere yerleştirebilir. Ziyaretçilere önerilen dili, ülkeyi veya para birimini değiştirmeleri için görünür bir yol sunun ve bu tercihi her ziyarette konumdan yeniden türetmek yerine koruyun.

Yalnızca uygun planlarda güvenlik bağlamı

Bunu içeren planlarda yanıt, liste tabanlı VPN/Tor/tehdit göstergeleri taşıyabilir. Atlanmış bir security nesnesi, alanın planınızda bulunmadığı anlamına gelir, ağın güvenli bulunduğu anlamına gelmez; false değeri, mevcut kaynak verilerde eşleşme olmadığı anlamına gelir ve bu, temiz bir sağlık raporuyla aynı şey değildir. Kapsam, göstergeye ve IP sürümüne göre değişir — örneğin IPv6 Tor tespiti şu anda uygulanmamaktadır.

Yanıttaki kullanışlı bağlam

country, region, city, latitude, longitude: Bağlanan istek için yaklaşık konum. Bir cihaz veya GPS konumu değildir ve belirli bir kişinin nerede olduğuna dair kanıt değildir.
timezone, currency, callingCode: Çözümlenen konumdan türetilen, başlangıç önerisi olarak kullanışlı bölgesel bağlam.
asn, asOrganization: Mevcut olduğunda, bağlanan ağ ve onun operatörü. Bir kuruluş adı bir kişinin kimliği değildir.
security: Planınız bunu içermiyorsa tamamen atlanır. Mevcut olduğunda: isVpn, isTor, isDatacenter, isThreat, isSanctionedNetwork — liste tabanlı göstergelerdir, güvenlik garantisi değildir.

İlk isteğinizi ekleyin

Tarayıcı 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 };
}

Yer tutucuyu ziyaretçi anahtarınızla değiştirin ve sayfayı o anahtar için izin verilen bir origin'den çalıştırın. İstek başarısız olursa veya bir alan eksikse sitenizin varsayılan deneyimini kullanılabilir tutun.

Sık sorulan sorular

Bu, cihaz konumu izni ister mi?

Hayır. IP tabanlı istek, tarayıcının cihaz Geolocation API'sini kullanmaz — cihaz tarafından sağlanan koordinatları istemek yerine konumu bağlantıdan tahmin eder. Kendi gizlilik ve onay yükümlülükleriniz yine de uygulamanızın sonucu nasıl kullandığına bağlıdır.

/v1/geo'ya bir IP adresi geçebilir miyim?

Hayır. Uç nokta her zaman bağlanan istemciyi tanımlar. Bir adres sağlamak istediğinizde sunucunuzdan /v1/lookup/{ip}'yi kullanın.

Sunucu tarafında oluşturulan bir istek neden barındırma sağlayıcımın konumunu gösteriyor?

Bu istek için bağlanan istemci sunucudur. Ziyaretçi isteğini tarayıcı koduna taşıyın veya sunucunuzdan, son kullanıcının IP'sinin güvenilir bir kaynağıyla IP sorgulama uç noktasını kullanın.

Şehir veya koordinat tam mıdır?

Hayır. IP konum tespiti, bir kişinin kesin konumu değil, bağlantıyla ilişkilendirilen bir tahmindir.

Tarayıcıda gizli bir anahtar kullanabilir miyim?

Hayır. Bu uç nokta için yayınlanabilir bir ziyaretçi anahtarı kullanın ve gizli sorgulama anahtarlarını yalnızca sunucu ortamınızda tutun.