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
휴대폰 기지국 데이터(예: 위치 지역 코드 및 모바일 국가 코드)
Wi-Fi 액세스 포인트 데이터(예: MAC 주소, 신호 강도)

Geolocation API 사용 방법

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

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

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

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

다음 단계