Geolocation API 개요

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

Geolocation API를 사용하는 이유

위치정보 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에서 다운로드할 수 있으며, 설치 안내와 샘플 코드도 확인할 수 있습니다.

다음 단계