버전 관리

주간 채널 선택

대부분 애플리케이션의 경우 주간 채널이 권장됩니다. 주간 채널이 가장 최신 버전이며 최신 버그 수정 및 성능 개선사항이 포함됩니다. 다음 스크립트 태그로 Maps JavaScript API를 로드하여 주간 채널을 지정할 수 있습니다.

  <script>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>
  

현재 주간 채널은 버전 3.58입니다. 이 버전은 매주 새로운 기능, 버그 수정, 성능 개선사항을 반영하여 업데이트됩니다.

11월 중순에 주간 채널이 버전 3.59로 업데이트됩니다. 이때 새 버전에서 지원 중단된 기능이 삭제되거나 이전 버전과의 비호환성 문제가 발생할 수 있습니다.

분기별 채널 선택

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

현재 분기별 채널은 버전 3.57입니다. 분기 중에는 이 버전에 새로운 기능, 버그 수정 또는 성능 개선사항이 추가되지 않습니다. 이 버전에 보안 버그 수정이 때때로 포함될 수 있습니다.

11월 중순에 분기별 채널이 버전 3.58로 업데이트됩니다. 새 버전에서는 새 기능이 추가되고 지원 중단된 기능이 삭제되거나 지난 3개월 동안의 버전과 비호환성 문제가 발생할 수 있습니다.

베타 채널 선택

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

이 채널은 weekly 채널을 기반으로 하며 일주일에 한 번 업데이트됩니다.

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </script>

알파 채널 선택

알파 채널을 통해 새로운 실험용 기능과 변경사항을 이용해 보세요. Issue Tracker를 사용하여 문제를 신고하고 의견을 제공하세요. 알파 채널에는 SLA 또는 지원 중단 정책이 적용되지 않으며 일부 변경사항은 이전 버전과 호환되지 않을 수도 있습니다. 개발 전용이며 프로덕션에 사용해서는 안 됩니다.

이 채널은 beta 채널을 기반으로 하며 일주일에 한 번 업데이트됩니다.

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </script>

버전 번호 선택

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.57,
  });
  </script>

현재 v=3.58, v=3.57, v=3.56 또는 v=3.55을 지정할 수 있습니다.

• 버전 3.58에는 새로운 기능, 버그 수정, 성능 개선사항이 반영된 주간 업데이트가 추가됩니다.
• 버전 3.57에는 주간 업데이트가 추가되지 않습니다.
• 버전 3.56에는 주간 업데이트가 추가되지 않습니다.
• 버전 3.55에는 주간 업데이트가 추가되지 않습니다.
• 이 버전에 보안 버그 수정이 때때로 포함될 수 있습니다.
• 새 버전을 만들 때 이전 버전과 더 이상 호환되지 않는 변경사항이 포함될 수 있습니다.

11월 중순 이후에는 v=3.59, v=3.58, v=3.57 또는 v=3.56를 지정할 수 있습니다.

• 버전 3.59에는 새로운 기능, 버그 수정, 성능 개선사항이 반영된 주간 업데이트가 추가됩니다.
• 버전 3.58에는 더 이상 주간 업데이트가 추가되지 않습니다.
• 버전 3.57에는 더 이상 주간 업데이트가 추가되지 않습니다.
• 버전 3.56에는 더 이상 주간 업데이트가 추가되지 않습니다.
• 이 버전에 보안 버그 수정이 때때로 포함될 수 있습니다.
• 버전 3.55는 더 이상 사용할 수 없습니다. 이 버전을 로드하려고 하면 무시되고 대신 기본 채널이 제공됩니다.

아래 다이어그램에는 내년에 각 채널에서 사용할 수 있는 버전이 나와 있습니다.

분기별 업데이트

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