
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 지도 서비스용 자바 클라이언트
- Google 지도 서비스용 Python 클라이언트
- Google 지도 서비스용 Go 클라이언트
- Google 지도 서비스용 Node.js 클라이언트
Google 지도 서비스용 자바 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 Apache 2.0 라이선스에 따라 오픈소스로 제공되는 클라이언트 지원 클라이언트 라이브러리입니다. GitHub에서 다운로드합니다. 여기에는 설치 안내 및 샘플 코드도 포함되어 있습니다.
다음 단계
- 샘플 요청 및 응답 시작하기: Geolocation 요청 및 응답으로 이동하세요.
- 권장사항 따르기: 웹 서비스 권장사항으로 이동하세요.
- 결제 이해하기: 사용량 및 결제로 이동합니다.