Geolocation API 개요

Geolocation API는 모바일 클라이언트가 감지할 수 있는 휴대폰 기지국 및 Wi-Fi 액세스 포인트에 대한 HTTPS 요청을 수락하는 서비스입니다. 위도/경도 좌표와 유효한 각 입력의 결과 정확도를 나타내는 반경을 반환합니다.

Geolocation API를 사용하는 이유

Geolocation API를 사용하여 네이티브 위치정보 기능을 제공하지 않는 휴대기기를 찾아보세요.

Geolocation API로 할 수 있는 작업

Geolocation API를 사용하면 휴대폰 기지국 및 Wi-Fi 노드의 지리정보 데이터를 사용하여 기본 위치정보 또는 GPS가 없는 기기의 위치를 가져올 수 있습니다.

Geolocation API 작동 방식

Geolocation API는 셀룰러 기기 데이터 필드, 기지국 데이터, Wi-Fi 액세스 포인트 배열 데이터를 사용하여 위도/경도 좌표와 정확도 반경을 반환합니다. 엔드포인트에 대한 HTTPS POST 요청을 구조화된 JSON 요청 본문과 함께 허용합니다. 다음 예시는 요청 URL과 요청 본문의 예를 보여줍니다. 

    https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

    {
      "homeMobileCountryCode": 310,
      "homeMobileNetworkCode": 410,
      "radioType": "gsm",
      "carrier": "Vodafone",
      "considerIp": true,
      "cellTowers": [
        // See the Cell Tower Objects section below.
      ],
      "wifiAccessPoints": [
        // See the WiFi Access Point Objects section below.
      ]
    }
API는 아래와 같이 여러 가지 일반적인 모바일 데이터 필드에 대한 데이터를 반환할 수 있습니다.

자료

다음 표에는 위치정보 엔드포인트 호출의 요청 본문에 있는 필드와 이러한 쿼리에서 제공하는 데이터 유형이 요약되어 있습니다.

데이터 리소스 데이터 반환됨 반환 형식
모바일 데이터 필드(예: 이동통신사, 기기 및 네트워크 정보) 위도/경도 좌표 및 정확도 반경 JSON
기지국 데이터(예: 위치 지역 번호, 모바일 국가 코드)
MAC 주소 및 신호 강도와 같은 Wi-Fi 액세스 포인트 데이터

Geolocation API 사용 방법

1 설정하기 Google Cloud 프로젝트 설정부터 시작하여 설정 안내를 완료합니다.
2 위치정보 요청 시도 API 키가 있으면 cURL 또는 Postman을 사용하여 Geolocation API를 테스트할 수 있습니다. 자세한 내용은 위치 정보 요청 및 응답 가이드의 샘플 요청을 참고하세요.
3 여러 라디오 타워에서 cellID 가져오기 이전 및 최신 타워에 각각 액세스하려면 cellID 계산 및 newRadioCellID 계산을 참고하세요.
4 응답 기본사항 이해하기 위치정보 데이터 응답을 탐색하여 앱에 고도 데이터를 사용할 준비를 합니다. 자세한 내용은 위치 정보 응답을 참고하세요.

사용 가능한 클라이언트 라이브러리

다음 클라이언트 라이브러리 중 하나를 통해 원하는 언어로 이 API를 호출합니다.

Google 지도 서비스용 자바 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 Apache 2.0 라이선스에 따라 오픈소스로 제공되는 클라이언트 지원 클라이언트 라이브러리입니다. GitHub에서 다운로드합니다. 여기에는 설치 안내 및 샘플 코드도 포함되어 있습니다.

다음 단계