버전 관리

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Maps JavaScript API팀은 새로운 기능, 버그 수정, 성능 개선을 위해 API를 정기적으로 업데이트합니다. 이 페이지에서는 애플리케이션에서 사용할 수 있는 API 버전을 설명합니다.

출시 채널 및 버전 번호

애플리케이션에서 출시 채널 또는 버전 번호를 지정할 수 있습니다.

  • 주간 채널v=weekly로 지정됩니다.
    이 채널은 매주 한 번 업데이트되며 최신 버전입니다.
  • 분기별 채널v=quarterly으로 지정됩니다.
    이 채널은 분기당 한 번 업데이트되며 예측 가능성이 가장 높습니다.
  • 베타 채널v=beta로 지정됩니다.
    이 채널은 weekly 채널을 기반으로 하며 주 1회 업데이트됩니다. 여기에는 초기 테스트와 의견 제공을 위한 추가 변경사항이 포함되어 있습니다.
  • 버전 번호v=n.nn으로 지정됩니다.
    v=3.50, v=3.49, v=3.48, v=3.47 중에서 선택할 수 있습니다.
    버전 번호는 분기당 한 번 업데이트됩니다 (분기별 업데이트 참고).

채널이나 버전을 명시적으로 지정하지 않으면 기본적으로 주간 채널이 수신됩니다. 프리미엄 플랜에서 이전했으며 채널이나 버전을 명시적으로 지정하지 않은 경우 기본적으로 분기별 채널이 제공됩니다. 잘못된 버전을 지정하면 기본 채널을 받게 됩니다.

주간 채널 선택하기

대부분의 경우 주별 채널을 추천합니다. 가장 최신 버전이며 최신 버그 수정 및 성능 개선을 포함합니다. 다음 스크립트 태그로 Maps JavaScript API를 로드하여 주간 채널을 지정할 수 있습니다.

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

현재 주간 채널은 3.50 버전입니다. 이 버전은 매주 새로운 기능, 버그 수정, 성능 개선을 위해 업데이트됩니다.

11월 중순에 주간 채널이 버전 3.51로 업데이트됩니다. 그때 새 버전은 지원 중단된 기능을 삭제하거나 이전 버전과 호환되지 않을 수 있습니다.

분기별 채널 선택

일부 애플리케이션의 경우 더 적은 예측이지만 더 큰 예측 가능성을 제공하기 때문에 업데이트가 더 유용할 수 있습니다. 이러한 애플리케이션은 분기별 채널을 사용해야 합니다. 버그 수정 및 성능 개선을 예상하는 시점에 실행하려면 이 방법을 사용하세요(분기별 업데이트 참고). 다음 스크립트 태그로 Maps JavaScript API를 로드하여 분기별 채널을 지정할 수 있습니다.

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

현재 분기별 버전은 3.49입니다. 분기 중에 이 버전에 새로운 기능, 버그 수정 또는 성능 개선이 적용되지 않습니다. 이 버전에 보안 버그 수정이 수시로 도입될 수 있습니다.

11월 중순에 분기별 채널이 3.50 버전으로 업데이트됩니다. 이때 새 버전에 새 기능이 포함되고, 지원 중단된 기능이 삭제되며, 이전 3개월의 이전 버전과의 비호환성이 발생합니다.

베타 채널 선택하기

베타 채널을 통해 새로운 베타 기능 및 변경사항을 사용해 보세요. 베타 기능은 완전한 기능이지만 해결되지 않은 문제가 있을 수 있습니다 (Issue Tracker를 사용하여 문제를 신고하고 의견을 제공하세요). 베타 채널에는 SLA 또는 지원 중단 정책이 적용되지 않으며 일부 변경사항은 이전 버전과 호환되지 않을 수 있습니다.

이 채널은 weekly 채널을 기반으로 하며 주 1회 업데이트됩니다.

다음 스크립트 태그로 Maps JavaScript API를 로드하여 베타 채널을 지정할 수 있습니다.

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

버전 번호 선택

애플리케이션을 정기적으로 테스트하고 업데이트하는 경우에만 숫자로 버전을 지정하세요. 번호가 매겨진 버전은 분기마다 새 버전이 생성될 때 결국 삭제되기 때문입니다. 다음 스크립트 태그로 Maps JavaScript API를 로드하여 버전 번호를 지정할 수 있습니다.

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

현재 v=3.50, v=3.49, v=3.48 또는 v=3.47을 지정할 수 있습니다.

  • 버전 3.50에는 새로운 기능, 버그 수정, 성능 개선사항이 포함된 업데이트가 매일 제공됩니다.
  • 버전 3.49에서 주간 업데이트를 수신하지 않습니다.
  • 버전 3.48에서 주간 업데이트를 수신하지 않습니다.
  • 버전 3.47에서 주간 업데이트를 수신하지 않습니다.
  • Google은 때때로 모든 버전에 보안 버그 수정을 도입할 수 있습니다.
  • 새 버전을 만들 때 이전 버전과 호환되지 않는 변경사항이 발생할 수 있습니다.

11월 중순 이후에는 v=3.51, v=3.50, v=3.49 또는 v=3.48을 지정할 수 있습니다.

  • 버전 3.51에는 새로운 기능과 버그 수정, 성능 개선이 포함된 업데이트가 매일 제공됩니다.
  • 버전 3.50은 더 이상 주간 업데이트를 받지 않습니다.
  • 버전 3.49에서는 더 이상 주간 업데이트를 받지 않습니다.
  • 버전 3.48은 더 이상 주간 업데이트를 받지 않습니다.
  • Google은 때때로 모든 버전에 보안 버그 수정을 도입할 수 있습니다.
  • 버전 3.47을 더 이상 사용할 수 없습니다. 이 버전을 로드하려고 하면 무시됩니다. 대신 기본 채널이 수신됩니다.

아래 다이어그램은 내년에 각 채널에서 사용할 수 있는 버전을 보여줍니다.

175

업데이트가 내 애플리케이션에 영향을 미쳤습니다.

출시 채널을 업데이트할 때 애플리케이션에 영향을 줄 수 있습니다. 애플리케이션이 문서화되지 않았거나 지원 중단된 기능을 사용하거나 Google에서 소개한 버그 또는 버그 수정으로 인해 발생할 수 있습니다.

임시 해결책으로 이전 버전을 사용하도록 애플리케이션을 재구성할 수 있습니다.

  1. 브라우저 개발자 도구에서 콘솔을 열고 google.maps.version의 값을 확인합니다.
  2. API를 로드하는 스크립트 태그를 업데이트하고 이전 버전 번호를 요청합니다.
    예를 들어 google.maps.version가 "3.50.2"이면 스크립트 태그에서 v=3.49를 사용합니다.
    이 임시 해결 방법은 한시적으로만 적용됩니다.

임시 해결 방법이 준비되면 애플리케이션을 업데이트할 시간 (일반적으로 3~6개월)이 주어집니다. 따라서 더 이상 문서화되지 않았거나 지원 중단된 기능이 사용되지 않으며 버그나 버그 수정이 반영됩니다.

그런 다음 원본 스크립트 태그로 되돌려 API를 로드해야 합니다.

지원 케이스를 만들거나 문제를 신고할 수도 있습니다.

분기별 업데이트

Maps JavaScript API팀은 분기당 한 번 새 버전을 출시합니다. 2월 중순, 5월 중순, 8월 중순, 11월 중순 다음 업데이트는 11월 중순에 출시됩니다. 새 주간 채널은 3.51 버전을 제공하며 그때 다른 채널도 업데이트됩니다.

주간 채널 업데이트

주간 채널은 현재 버전 3.50을 가리킵니다.

11월 중순에 주간 채널이 버전 3.50에서 버전 3.51로 업데이트됩니다. 이 시점에서 새 버전에 새 기능이 포함되고, 지원 중단된 기능이 삭제되며, 이전 버전과의 비호환성이 발생합니다. 채널이 업데이트되면 이러한 변경사항을 테스트해야 할 수 있습니다.

분기 동안 새 버전은 매주 새로운 기능, 버그 수정, 성능 개선과 함께 업데이트됩니다. 지원 중단된 기능이 삭제되지 않으며 이전 버전과의 비호환성이 발생하지 않습니다.

분기별 채널 업데이트

현재 분기별 버전은 버전 3.49를 가리킵니다.

11월 중순에 분기 채널이 버전 3.49에서 버전 3.50으로 업데이트됩니다. 업데이트가 완료되면 이 버전에 새로운 기능이 포함되고, 지원 중단된 기능이 삭제되며, 이전 3개월의 하위 호환성이 도입됩니다. 채널이 업데이트되면 이러한 변경사항을 테스트해야 할 수 있습니다.

분기 중에 이 버전에 새로운 기능, 버그 수정 또는 성능 개선사항이 포함되지 않습니다. 지원 중단된 기능이 삭제되지 않으며 이전 버전과의 비호환성이 발생하지 않습니다.

버전 업데이트

11월 중순이 되면 버전 번호가 새 버전의 출시를 수용하기 위해 이월됩니다.

버전 3.51

새 버전 3.51이 11월 중순에 출시될 예정입니다. 출시되면 이 버전에는 새로운 기능이 포함되고, 지원 중단된 기능이 삭제되며, 버전 3.50과 비교할 때 이전 버전과의 비호환성이 발생합니다. 버전 번호를 변경할 때는 애플리케이션을 테스트해야 합니다.

분기 중에 새 버전은 매주 새로운 기능, 버그 수정, 성능 개선과 함께 업데이트됩니다. 지원 중단된 기능이 삭제되지 않으며 이전 버전과의 비호환성이 발생하지 않습니다.

버전 3.50

이 버전은 새로운 기능을 포함하고 지원 중단된 기능을 삭제하며 버전 3.49에 비해 이전 버전과 호환되지 않습니다. 버전 번호를 변경할 때는 애플리케이션을 테스트해야 합니다.

11월 중순 이후에는 이 버전에 새로운 기능, 버그 수정 또는 성능 개선사항이 더 이상 업데이트되지 않습니다. 지원 중단된 기능이 삭제되지 않으며 이전 버전과의 비호환성이 발생하지 않습니다.

버전 3.49

이 버전에는 새로운 기능이 포함되어 있고 지원 중단된 기능이 삭제되었으며 버전 3.48과 비교할 때 이전 버전과의 비호환성이 도입되었습니다. 버전 번호를 변경할 때는 애플리케이션을 테스트해야 합니다.

이 버전은 더 이상 새로운 기능, 버그 수정 또는 성능 개선으로 업데이트되지 않습니다. 이 버전 이후에 지원 중단된 기능은 삭제되지 않으며 새로운 이전 버전과의 비호환성이 발생하지 않습니다.

버전 3.48

이 버전은 새로운 기능을 포함하고 지원 중단된 기능을 삭제하며 버전 3.47과 비교하여 이전 버전과 호환되지 않습니다. 버전 번호를 변경할 때는 애플리케이션을 테스트해야 합니다.

이 버전은 더 이상 새로운 기능, 버그 수정 또는 성능 개선으로 업데이트되지 않습니다. 이 버전 이후에 지원 중단된 기능은 삭제되지 않으며 새로운 이전 버전과의 비호환성이 발생하지 않습니다.

버전 3.47

11월 중순 이후에는 이 버전이 삭제되어 더 이상 사용할 수 없게 됩니다. 이 버전을 로드하려고 하면 무시됩니다. 대신 기본 채널이 수신됩니다.

버전 지원

특정 분기에 4개의 버전을 사용할 수 있습니다. 이 4가지 버전이 모두 지원됩니다.

버전 확인

디버깅의 경우 google.maps.version 속성을 사용하여 애플리케이션에서 Maps JavaScript API의 현재 버전을 가져옵니다. 다음 코드 샘플은 브라우저 콘솔에 API 버전을 기록합니다. 브라우저 콘솔에 관한 자세한 내용은 브라우저에서 오류 확인 가이드를 참고하세요.

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

API 버전 관련 문서

개발자 가이드에서는 항상 주간 버전을 설명합니다.

또한, 각 버전에 대해 별도로 관리되는 참조가 있습니다.