Google Maps 웹 서비스용 클라이언트 라이브러리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google 지도 서비스용 Java Client, Python Client, Go Client,
Node.js Client는 커뮤니티 지원 클라이언트 라이브러리로,
Apache 2.0 License에 따라 오픈 소스로 제공됩니다. 이러한 라이브러리는
GitHub에서 다운로드와 참여가 가능합니다. GitHub에서는 설치 안내와 샘플 코드도 찾을 수
있습니다.
클라이언트 라이브러리를 사용해야 하는 이유
Google 지도 서비스용 Java Client, Python Client, Go Client,
Node.js 클라이언트를 사용하면 서버에서 Google 지도 웹 서비스를 이용할 수 있습니다.
여기에는 다음 API 기능도 포함됩니다.
이러한 API에서 제공하는 기능 외에도, 클라이언트 라이브러리를 사용하면 몇 가지 일반적인 작업을 더 쉽게 수행할 수 있습니다.
- 자동 비율 제한 기본적으로 요청은 각 웹 서비스의 예상 속도 제한 내에서
전송됩니다.
new GeoApiContext().setQueryRateLimit(qpm)
로 맞춤 QPM 한도를 제공할 수 있습니다.
- 실패 시 재시도 API에서
5xx
오류를 전송하면 클라이언트 라이브러리가 요청을
자동으로 재시도합니다. 재시도는 지수 백오프를 사용하며, 일시적인 실패
시에 도움이 됩니다.
- 손쉬운 인증 클라이언트 라이브러리를 사용하면 사용 가능한 무료 API 키로
쉽게 인증할 수 있습니다. Google Maps Platform 프리미엄 플랜 고객은
자신의 클라이언트 ID와 보안 비밀을 사용할 수 있습니다.
- POJO 자바 라이브러리는 각 API 응답에 대해 네이티브 객체를
반환합니다. Python 라이브러리는 API에서 수신한 구조를 반환합니다.
- 비동기 또는 동기 모든 요청은 동기 또는 비동기 호출 스타일을
지원합니다.
이용약관
Google 지도 웹 서비스의 클라이언트 라이브러리는 Apache 2.0 라이선스에 따라
라이선스가 부여됩니다.
클라이언트 라이브러리는 Google 지도 웹 서비스용 래퍼입니다. Google 지도 웹 서비스에는
Google Maps Platform 서비스 약관이 적용됩니다.
중요: 이 라이브러리에는 표준 Google 지원 중단 정책 또는
지원 계약이 적용되지 않습니다.
API 키 및 클라이언트 ID
각 Google Maps 웹 서비스에는 API 키 또는 클라이언트 ID가 필요합니다. API 키 사용 시기,
클라이언트 ID 사용 시기, API 키 또는 클라이언트 ID를 가져오는 방법은 사용 중인
API의 인증 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eCommunity-supported client libraries for Google Maps Services are available in Java, Python, Go, and Node.js, enabling server-side interaction with various Google Maps APIs like Directions, Geocoding, and Places.\u003c/p\u003e\n"],["\u003cp\u003eThese open-source libraries, under the Apache 2.0 License, offer benefits such as automatic rate limiting, request retries, simplified authentication, and support for both synchronous and asynchronous calls.\u003c/p\u003e\n"],["\u003cp\u003eWhile providing convenient wrappers for Google Maps web services, these client libraries are not covered by standard Google support or deprecation policies and are subject to the Google Maps Platform Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eAccessing Google Maps web services requires an API key or client ID; refer to the authentication guide for your specific API for details on obtaining and using these credentials.\u003c/p\u003e\n"]]],["Community-supported Java, Python, Go, and Node.js client libraries for Google Maps Services are available on GitHub under the Apache 2.0 License. These clients wrap APIs like Address Validation, Directions, and Places, offering features such as automatic rate limiting, retry on failure, and easy authentication via API keys or client IDs. They facilitate server-side interaction with Google Maps web services. The libraries support both synchronous and asynchronous requests.\n"],null,["The Java Client, Python Client, Go Client and\nNode.js Client for Google Maps Services are community supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0). They are\navailable for download and contributions on GitHub, where you will also find installation\ninstructions and sample code: \n\n- [Java Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nWhy use the client libraries?\n\nThe Java Client, Python Client, Go Client\nand Node.js Client for Google Maps Services enable you to work with Google Maps web services on your server.\nThey wrap the functionality of the following APIs:\n\n- [Address Validation API](/maps/documentation/address-validation/overview)\n- [Directions API (Legacy)](/maps/documentation/directions/start)\n- [Distance Matrix API (Legacy)](/maps/documentation/distancematrix/start)\n- [Elevation API](/maps/documentation/elevation/start)\n- [Geocoding API](/maps/documentation/geocoding/start)\n- [Places API](/maps/documentation/places/web-service/overview)\n- [Roads API](/maps/documentation/roads/overview)\n- [Time Zone API](/maps/documentation/timezone/start)\n\nIn addition to the functionality provided by these APIs, the client libraries\nmake some common tasks a little easier.\n\n- **Automatic Rate Limiting** By default, requests are sent at the expected rate limit for each web service. You can provide custom QPM limits with `new GeoApiContext().setQueryRateLimit(qpm)`.\n- **Retry on Failure** The client libraries will automatically retry any request if the API sends a `5xx` error. Retries use exponential back-off, which helps in the event of intermittent failures.\n- **Easy Authentication** The client libraries make it easy to authenticate with your freely available API Key. [Google Maps Platform Premium Plan](/maps/premium) customers can use their [client ID and secret](/maps/premium/overview#client-id).\n- **POJOs** The Java libraries return native objects for each of the API responses. The Python libraries return the structure as it is received from the API.\n- **Asynchronous or synchronous** All requests support synchronous or asynchronous calling style.\n\nTerms and conditions\n\nThe client libraries for the Google Maps web services are licensed under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\n\nThe client libraries are wrappers for the Google Maps web services. The Google Maps\nweb services are governed by the [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms).\n\n**Important** : These libraries are **not covered**\nby the standard Google deprecation policy or support agreement.\n\nAPI keys and client IDs\n\nEach Google Maps web service requires an API key or client ID. For a guide on\nwhen to use an API key, when to use a client ID, and how to get hold of your\nAPI key or client ID, see the authentication guide for the API you're using:\n\n- [Address Validation API](/maps/documentation/address-validation/get-api-key)\n- [Directions API (Legacy)](/maps/documentation/directions/get-api-key)\n- [Distance Matrix API (Legacy)](/maps/documentation/distancematrix/get-api-key)\n- [Elevation API](/maps/documentation/elevation/get-api-key)\n- [Geocoding API](/maps/documentation/geocoding/get-api-key)\n- [Places API](/maps/documentation/places/web-service/get-api-key)\n- [Roads API](/maps/documentation/roads/get-api-key)\n- [Time Zone API](/maps/documentation/timezone/get-api-key)"]]