Watch-IP

웹사이트를 위한 방문자 지오로케이션

방문자의 브라우저에서 직접 GET /v1/geo를 호출해 해당 연결에서 확인 가능한 국가, 도시, 시간대, 지역 정보를 받으세요. 허용된 오리진을 설정하고 공개 가능 키를 추가한 뒤, 애플리케이션이 응답을 어떻게 처리할지 결정하세요.

무료 방문자 API 키 받기빠른 시작 보기 →

요청은 방문자의 브라우저에서 발생합니다

GET /v1/geo는 항상 연결하는 클라이언트를 설명합니다. 방문자의 브라우저에서 호출하면 해당 연결의 위치 데이터를 받게 됩니다. 애플리케이션 서버에서 보낸 요청은 방문자가 아니라 서버 자신의 연결을 설명합니다. 이미 최종 사용자의 IP 주소를 가지고 있고 백엔드에서 확인해야 한다면 별도의 IP 조회 API를 사용하세요. 방문자 키는 공개 가능한 키입니다 — 브라우저 코드에 노출되도록 설계되었으므로, 실제 제어 수단은 키 자체의 비밀 유지가 아니라 설정된 허용 오리진 목록입니다.

강제 리디렉션이 아닌 제안으로 설계하세요

여행자는 한 국가의 네트워크를 사용하면서도 다른 언어를 선호할 수 있으며, VPN은 연결을 완전히 다른 곳으로 위치시킬 수 있습니다. 방문자가 제안된 언어, 국가, 통화를 직접 변경할 수 있는 눈에 띄는 방법을 제공하고, 방문할 때마다 위치로부터 다시 추정하는 대신 그 선택을 유지하세요.

이용 가능한 요금제에서만 제공되는 보안 정보

이 정보를 포함하는 요금제에서는 응답에 리스트 기반 VPN/Tor/위협 지표가 포함될 수 있습니다. 보안 객체가 생략되었다는 것은 해당 필드가 요금제에 포함되지 않았다는 뜻이지 네트워크가 안전하다고 확인되었다는 뜻이 아닙니다. false 값은 이용 가능한 소스 데이터에서 일치 항목이 없다는 뜻이며 이는 안전 확인과 다릅니다. 커버리지는 지표와 IP 버전에 따라 다릅니다 — 예를 들어 IPv6 Tor 탐지는 현재 구현되어 있지 않습니다.

응답에서 유용한 정보

country, region, city, latitude, longitude
연결된 요청의 근사 위치입니다. 기기나 GPS 위치가 아니며 특정 인물의 소재를 증명하지 않습니다.
timezone, currency, callingCode
확인된 위치를 기반으로 파생된 지역 정보로, 초기 제안값으로 유용합니다.
asn, asOrganization
이용 가능한 경우 연결된 네트워크와 그 운영자입니다. 조직명은 개인의 신원이 아닙니다.
security
요금제에 포함되지 않으면 완전히 생략됩니다. 포함된 경우: isVpn, isTor, isDatacenter, isThreat, isSanctionedNetwork — 리스트 기반 지표이며 안전을 보장하지 않습니다.

첫 요청 추가하기

브라우저 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 };
}

표시된 값을 방문자 키로 교체하고, 해당 키에 허용된 오리진에서 페이지를 실행하세요. 요청이 실패하거나 필드가 누락된 경우에도 사이트의 기본 경험을 계속 이용할 수 있도록 유지하세요.

자주 묻는 질문

이 요청이 기기 위치 권한을 요구하나요?

아닙니다. IP 기반 요청은 브라우저의 기기 Geolocation API를 사용하지 않습니다 — 기기가 제공하는 좌표를 요청하는 대신 연결로부터 위치를 추정합니다. 다만 애플리케이션이 결과를 어떻게 사용하는지에 따라 자체 개인정보 보호 및 동의 의무는 여전히 적용됩니다.

/v1/geo에 IP 주소를 전달할 수 있나요?

아닙니다. 이 엔드포인트는 항상 연결하는 클라이언트를 설명합니다. 주소를 제공하려면 백엔드에서 /v1/lookup/{ip}를 사용하세요.

서버 렌더링 요청이 왜 제 호스팅 제공업체의 위치를 보여주나요?

해당 요청에서는 서버가 연결하는 클라이언트입니다. 방문자 요청을 브라우저 코드로 옮기거나, 최종 사용자의 IP를 신뢰할 수 있는 소스로 확보한 뒤 백엔드에서 IP 조회 엔드포인트를 사용하세요.

도시나 좌표가 정확한가요?

아닙니다. IP 지오로케이션은 연결과 연관된 추정치이며 개인의 정확한 위치가 아닙니다.

브라우저에서 시크릿 키를 사용할 수 있나요?

아닙니다. 이 엔드포인트에는 공개 가능한 방문자 키를 사용하고, 시크릿 조회 키는 백엔드 환경에만 두세요.

관련 페이지