Geolocation API 개요

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

Geolocation API를 사용하는 이유

Geolocation API를 사용하여 기본 위치정보 기능을 제공하지 않는 휴대기기를 찾을 수 있습니다.

Geolocation API로 할 수 있는 작업

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

Geolocation API 작동 방식

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

curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d \
'{ "homeMobileCountryCode":310,
   "homeMobileNetworkCode":410,
   "radioType":"gsm",
   "carrier":"Vodafone",
   "considerIp":true
}'
API는 아래와 같이 여러 일반적인 모바일 데이터 필드에 관한 데이터를 반환할 수 있습니다.

자료

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

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

Geolocation API 사용 방법

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

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

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

Google 지도 서비스용 Java Client, Python Client, Go Client, Node.js Client는 커뮤니티에서 지원하는 클라이언트 라이브러리로, Apache 2.0 라이선스에 따라 오픈소스로 제공됩니다. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 확인할 수 있습니다.

다음 단계