라이브러리

Maps JavaScript API용 자바스크립트 코드를 로드하려면 페이지에 https://maps.googleapis.com/maps/api/js 형태의 부트스트랩 URL을 포함합니다. 이 부트스트랩 요청은 Maps JavaScript API에서 사용할 주요 자바스크립트 객체와 기호를 모두 로드합니다. 일부 API 기능은 필요한 모든 기능이 포함된 독립 라이브러리에도 제공되며, 이러한 라이브러리는 구체적으로 요청하지 않는 한 로드되지 않습니다. 추가 구성요소를 라이브러리로 분할하면 기본 API가 빠르게 로드 및 파싱될 수 있습니다. 필요한 경우에만 라이브러리 로드 및 파싱 오버헤드가 추가로 발생합니다.

부트스트랩 요청에 libraries 매개변수를 지정하고 라이브러리의 이름을 제공하여 추가 라이브러리를 로드할 수 있습니다. 여러 라이브러리를 쉼표로 구분된 목록으로 지정할 수 있습니다. 그런 다음 google.maps.libraryName 네임스페이스를 통해 라이브러리에 액세스할 수 있습니다.

다음과 같은 라이브러리를 사용할 수 있습니다.

  • drawing은 사용자가 지도에 다각형, 직사각형, 다중선, 원 및 마커를 그릴 수 있는 그래픽 인터페이스를 제공합니다. 자세한 내용은 그리기 라이브러리 문서를 참고하세요.
  • geometry에는 지구 표면의 스칼라 도형 값(예: 거리, 면적)을 계산하기 위한 유틸리티 함수가 포함되어 있습니다. 자세한 내용은 도형 라이브러리 문서를 참고하세요.
  • journeySharing은 Google Maps Platform 운송 및 물류 솔루션을 지원합니다.
  • localContext는 지정된 위치 주변의 주요 관심 장소를 사용자에게 표시합니다. 자세한 내용은 로컬 컨텍스트 라이브러리 문서를 참고하세요.
  • marker를 사용하면 세부적인 맞춤설정이 가능하고 성능이 뛰어난 고급 마커를 지도에 추가할 수 있습니다. 자세한 내용은 고급 마커 문서를 참고하세요.
  • places를 사용하면 애플리케이션이 정의된 지역 내에서 시설, 지리적 위치, 주요 관심 장소 등의 장소를 검색할 수 있습니다. 자세한 내용은 장소 라이브러리 문서를 참고하세요.
  • visualization은 데이터의 시각적 표현을 위한 히트맵을 제공합니다. 자세한 내용은 시각화 라이브러리 문서를 참고하세요.

미리보기: 베타 채널(v=beta)에서 다음 라이브러리를 사용할 수 있습니다.

다음 부트스트랩 요청은 Maps JavaScript API의 google.maps.geometry 라이브러리를 요청하는 방법을 보여줍니다.

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry&callback=initMap">
</script>

여러 라이브러리를 요청하려면 다음과 같이 쉼표로 구분하세요.

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry,places&callback=initMap">
</script>