이 페이지는 Cloud Translation API를 통해 번역되었습니다.

자주 묻는 질문(FAQ)

시작하기
API 사용
문제 해결
Google 시각화 API 정책
커뮤니티에서 활동적인 되기

시작하기

Google 시각화 API란 무엇인가요?: Google 시각화 API를 사용하면 구조화된 데이터를 토대로 차트 및 보고서 애플리케이션을 만들고 이를 웹사이트에 직접 통합할 수 있습니다.
시각화 API로 무엇을 할 수 있나요?: Google 시각화 API를 사용하면 브라우저에서 로컬로 생성하거나 지원되는 데이터 소스에서 간단한 표 형식으로 가져온 구조화된 데이터에 액세스할 수 있습니다. 자체 데이터 소스를 시각화 API 데이터 소스로 구현하고 시각화 규정을 준수하는 시각화 또는 애플리케이션이 데이터에 액세스하도록 할 수도 있습니다. 보고, 분석 또는 차트 애플리케이션에서 사용하기에 적합한 형식입니다. 따라서 데이터를 시각화하거나 Google 스프레드시트와 같은 애플리케이션에 새 기능을 추가할 수 있습니다.
시각화 API에 대한 문서는 어디에서 찾을 수 있나요?: 개발자 가이드 및 기타 모든 관련 문서는 https://developers.google.com/chart/interactive/docs에서 확인할 수 있습니다.
새 차트를 만들려면 어떻게 해야 하나요?: 시작하는 데 가장 좋은 방법은 소개와 빠른 시작 섹션을 읽는 것입니다.
데이터 소스 URL이란 무엇인가요?: 데이터 소스 URL은 시각화 API 데이터 소스의 고유 URL 식별자입니다. 데이터 소스 URL에는 차트 쿼리 언어 매개변수가 포함될 수도 있습니다. 이 경우 데이터를 가져오기 전에 데이터 소스에서 쿼리 (예: 정렬, 그룹화 등)가 실행됩니다.
시각화 API를 사용하는 차트 앱의 예시 코드는 어디에서 찾을 수 있나요?: 시각화 API 예시 코드 문서에서 예시 코드를 확인할 수 있습니다.
Flash 애플리케이션이 시각화 API에 액세스할 수 있나요?: 물론입니다. 시각화 API는 JavaScript API를 사용하지만, Flash 앱을 자바스크립트 코드와 연결할 수 있도록 하는 라이브러리가 있습니다. 이러한 라이브러리 중 하나는 http://code.google.com/p/swfobject에서 유용하게 사용할 수 있습니다. Flash에 영향을 주는 몇 가지 개발 문제는 아래를 참조하세요.
데이터 소스는 어떻게 구현하나요?: 차트 사용 및 만들기 섹션에서 차트 작동 방식을 알아본 다음 데이터 소스 구현에서 데이터 소스를 만드는 방법을 알아보세요. 자바를 사용하는 경우 Google 차트 데이터 소스 자바 라이브러리를 사용하여 빠르게 시작할 수도 있습니다.
Java 애플리케이션에서 차트에 액세스할 수 있나요?: 예. Google Web Toolkit (GWT)용 Google 시각화 라이브러리를 사용하면 GWT 컴파일러로 컴파일된 Java 코드에서 API 호환 시각화에 액세스하고 GWT 컴파일러를 사용하여 Java에서 시각화 API 호환 시각화를 작성할 수 있습니다. 출시 후보 라이브러리는 시각화 API 이벤트 모델도 지원합니다.
GWT (Google 웹 툴킷) 컴파일러로 작성된 애플리케이션에서 차트에 액세스할 수 있나요?: 예. Google Web Toolkit (GWT)용 Google 시각화 라이브러리를 사용하면 GWT 컴파일러로 컴파일된 Java 코드에서 API 호환 시각화에 액세스하고 GWT 컴파일러를 사용하여 Java에서 시각화 API 호환 시각화를 작성할 수 있습니다. 출시 후보 라이브러리는 시각화 API 이벤트 모델도 지원합니다.
다른 질문/문제가 있습니다. 자세한 정보를 얻으려면 어디로 문의해야 하나요?: Google 시각화 API 토론 그룹에 질문을 게시하여 시각화 개발자 커뮤니티의 도움을 받으세요. Google 시각화팀도 이 그룹에 참여하여 질문에 답변합니다.

API 사용

Google 차트 API와 Google 시각화 API의 차이점은 무엇인가요?

Chart API는 데이터와 차트 구성 옵션을 모두 포함하는 형식이 지정된 URL을 Google 서버로 전송하여 다양한 종류의 이미지 차트를 만드는 간단한 방법을 제공합니다. Chart API에는 다양한 옵션이 있는 비공개 차트 세트가 포함되어 있습니다. Chart API 데이터 세트는 URL 크기 (약 2,000개)로 제한됩니다.

시각화 API는 웹에서 차트와 데이터 소스를 연결하고 게시할 수 있는 방법을 제공합니다.

시각화 API는 차트에 액세스하기 위한 JavaScript API를 제공합니다.
차트 갤러리에는 Google에서 만든 차트가 포함되어 있지만 제3자가 자체 시각화 API 호환 시각화를 만들 수도 있습니다.
시각화 API 차트 및 차트는 브라우저에서 렌더링할 수 있는 모든 항목이 될 수 있습니다. 여기에는 이미지, 자바스크립트, 벡터 그래픽, 플래시 등이 포함됩니다.
시각화 API를 통해 상당수의 Chart API 차트에 액세스할 수 있지만 일부 구성 옵션은 제공되지 않을 수 있습니다.
또한 API는 문서화된 전송 프로토콜을 제공하며 누구나 데이터 소스를 API 시각화에 노출할 수 있는 방법을 제공합니다.
API에는 차트에서 이벤트를 발생시키고 수신하여 호스트 페이지 또는 페이지의 다른 차트와 통신할 수 있도록 하는 정의된 이벤트 모델이 있습니다.

시각화 API를 사용하여 어떤 데이터 소스에 액세스할 수 있나요?

시각화 API를 사용하면 API의 표준 DataTable 형식을 생성하여 브라우저에서 로컬로 데이터에 액세스하거나 API를 지원하는 모든 데이터 소스에 액세스할 수 있습니다. 이 API를 이미 지원하는 잘 알려진 애플리케이션으로는 Force.com 개발자 플랫폼의 Google 스프레드시트와 Salesforce.com이 있습니다. 자체 데이터를 차트 데이터 소스로 구현할 수도 있습니다.

애플리케이션에서 수신하는 데이터가 특정 형식일 것으로 예상합니다. 예외를 처리하려면 어떻게 해야 하나요?

google.visualization.DataTable 클래스의 getNumberOfColumns() 및 getColumnType() 메서드를 사용하여 가져온 데이터가 예상한 데이터와 일치하는지 테스트하고 불일치 오류 메시지를 표시할 수 있습니다.

내 웹사이트에 차트를 삽입해도 안전한가요?

웹사이트에서 직접 서드 파티 코드를 실행하면 내재된 위험이 발생합니다. Google에서는 애플리케이션 성능, 품질, 보안 또는 콘텐츠에 대해 어떠한 약속이나 진술도 하지 않습니다. Google 시각화 API 서비스 약관을 준수하지 않는 차트 애플리케이션은 갤러리에서 삭제될 수 있습니다.

차트를 오프라인으로 사용할 수 있나요?

Google 차트의 대화형 기능을 사용하려면 사용자의 컴퓨터에 https://www.gstatic.com/charts/loader.js에 대한 액세스 권한이 있어야 합니다. 페이지에 필요한 시각화 라이브러리가 사용 전에 동적으로 로드되기 때문입니다. 적절한 라이브러리를 로드하는 코드는 포함된 스크립트의 일부이며, google.charts.load() 메서드를 호출할 때 호출됩니다. Google 서비스 약관에 따라 google.charts.load 또는 google.visualization 코드를 다운로드하여 오프라인에서 사용하는 것은 허용되지 않습니다.

차트 코드를 로컬 또는 인트라넷에서 다운로드하여 호스팅할 수 있나요?

죄송합니다. Google 서비스 약관에 따라 google.charts.load 또는 google.visualization 코드를 다운로드, 저장 또는 호스팅할 수 없습니다. 하지만 Google 차트의 상호작용이 필요하지 않은 경우 차트의 스크린샷을 찍고 원하는 대로 사용할 수 있습니다.

문제 해결

차트가 표시되지 않는 이유는 무엇인가요?

먼저 JavaScript 콘솔을 확인합니다. Chrome에서는 Chrome->보기->개발자->JavaScript 콘솔이나 Chrome->도구->JavaScript 콘솔을 통해 JavaScript 콘솔에 액세스할 수 있습니다. 모든 최신 브라우저에는 JavaScript 콘솔이 있습니다. '고급' 또는 '개발자 도구'와 같은 이름을 써서 메뉴를 찾아야 할 수도 있습니다.

콘솔에서 문제를 즉시 해결할 수 있기를 바랍니다. 하지만 콘솔 메시지를 근본적인 원인으로 해석하기 어려울 때도 있습니다. 일반적인 함정은 다음과 같습니다.

Google 로더를 잘못 사용하고 있을 수 있습니다.

chart/loader.js를 한 번만 로드합니다. 웹페이지에 있는 차트 수와 상관없이 다음과 같은 호출이 한 번만 있어야 합니다.
```
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
```
로드가 발생하는 시점에 따라 웹페이지의 헤드 또는 본문에 포함될 수 있습니다.

웹페이지에 필요한 모든 패키지를 포함하여 google.charts.load를 한 번만 호출하는 것이 좋습니다.

<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script>
  google.charts.load("current", {packages: ["corechart", "timeline"]});

  google.charts.setOnLoadCallback(drawBarChart1);
  function drawBarChart1() {
    ...
    var barChart1 = new google.visualization.BarChart(document.getElementById('chart1'));
    ...
  }

  google.charts.setOnLoadCallback(drawBarChart2);
  function drawBarChart2() {
    ...
    var barChart2 = new google.visualization.BarChart(document.getElementById('chart2'));
    ...
  }

  google.charts.setOnLoadCallback(drawTimeline);
  function drawTimeline() {
    ...
    var timeline = new google.visualization.Timeline(document.getElementById('chart3'));
    ...
  }

</script>
<div id="chart1"></div>
...
<div id="chart2"></div>
...
<div id="chart3"></div>

모든 차트에는 고유한 요소 ID(예: chart1, chart2).
오타를 찾습니다. 자바스크립트는 대소문자를 구분하는 언어입니다.

여전히 문제가 해결되지 않으면 Google 시각화 API 토론 그룹을 검색하여 비슷한 문제를 경험한 사람이 있는지 확인하세요. 질문에 답변이 되는 게시물을 찾을 수 없는 경우 문제를 보여주는 웹페이지 링크와 함께 질문을 그룹에 게시하세요. 가능하면 jsfiddle을 포함하세요.

왜 월과 일이 한 명씩 안 있죠?

Google 차트는 0부터 시작하는 색인 생성을 사용하는 JavaScript를 사용합니다. 월의 1일은 0이고, 월 범위는 0 (1월)에서 11월 (12월)까지입니다. 코드에서 1 기반 색인 생성을 가정하는 경우 데이터를 자바스크립트 날짜 객체에 넣기 전에 1을 차감합니다.

차트가 일부 브라우저에서는 작동하지만 일부 브라우저에서는 작동하지 않는 이유는 무엇인가요?

브라우저 비호환성에 대한 자세한 내용은 caniuse.com을 참조하세요. Google 차트를 사용하면 Internet Explorer 8 이하에서 다음과 같은 두 가지 이유로 문제가 발생할 수 있습니다.

IE8은 SVG를 지원하지 않으므로 더 제한적인 VML로 차트를 장애 조치합니다.

IE8의 JavaScript는 목록에서 후행 쉼표를 허용하지 않습니다.

테스트할 때 플래시 기반 차트가 표시되지 않는 이유는 무엇인가요?

Flash 보안 설정으로 인해 웹 서버 URL (예: http://www.myhost.com/myviz.html)이 아닌 브라우저의 파일 위치 (예: file:///c:/webhost/myhost/myviz.html)에서 액세스하면 Flash 기반 차트가 제대로 작동하지 않을 수 있습니다. 이 문제는 일반적으로 테스트 문제일 뿐이며 http:// 주소에서 차트에 액세스할 때는 문제가 아닙니다. Macromedia 웹사이트에 설명된 대로 이 문제를 해결할 수 있습니다. 일반적으로 가능하면 플래시 개발은 피하는 것이 좋습니다.

Google 시각화 프로그램 정책

Google 시각화 프로그램 정책이란 무엇인가요?

서비스 약관에 명시된 바와 같이 Google은 다음을 표시하거나 링크하여 Google 프로그램 정책을 위반하는 콘텐츠의 포함 및 표시를 거부할 수 있습니다.

불법 콘텐츠
사생활 침해
포르노 또는 음란물
악성 코드와 같이 사용자의 컴퓨터 또는 호스트 웹페이지의 작동을 방해하거나 유해한 콘텐츠
증오심을 조장하거나 폭력을 선동하는 내용
상표권 위반
제3자의 명의 도용.

데이터를 수집하는 차트를 만들고 법적으로 적합한 개인정보처리방침을 유지관리하고 연결하는 데 동의하는 개발자 또한 개발자는 차트가 안전한지 확인하고 차트 디렉터리에 있는 한 애플리케이션을 유지해야 합니다.

이러한 정책은 예고 없이 수시로 변경될 수 있습니다.

Google 시각화 API를 상업적으로 사용할 수 있나요?

예. 세부사항은 Google 시각화 API 서비스 약관을 참고하세요.

Google 시각화 API를 사용하여 클라이언트 측 소프트웨어를 만들 수 있나요?

현재는 개발자가 시각화 API를 사용하여 클라이언트 측 소프트웨어를 만드는 것을 허용하지 않습니다. 제공된 인터페이스를 통해서만 시각화 API를 사용할 수 있습니다. 세부사항은 Google 시각화 API 서비스 약관을 참고하세요.

Google에서 내 차트 데이터를 모두 기록하나요?

HTTP 요청에 포함된 차트 데이터는 내부 테스트 및 디버깅 목적으로 2주 이하의 임시 로그에 저장됩니다. 물론 차트가 공개 웹페이지의 이미지 태그에 표시되면 차트가 크롤링될 수 있다는 점을 알아야 합니다.

프로그램 정책 위반

이러한 프로그램 정책을 위반하면 차트가 사용 중지 또는 삭제되고 향후 차트를 업로드할 수 없도록 차단되거나 Google 계정이 해지되거나 모든 차트가 삭제될 수 있습니다.

커뮤니티에서 적극적으로 활동하기

차트 애플리케이션을 다른 사용자와 공유하려면 어떻게 해야 하나요?: 먼저 차트 갤러리에 차트를 배치합니다. 원하는 경우 사이트로 다시 연결하고 소스 코드를 제공할 수 있습니다. 토론방에 참여하여 커뮤니티의 의견을 받으세요.
차트 갤러리란 무엇인가요?: 차트 갤러리는 시각화 API를 사용하는 애플리케이션의 목록입니다. 시각화 개발자 커뮤니티가 차트 애플리케이션을 공유할 수 있는 중앙 위치를 제공합니다. 갤러리에 차트 신청서를 제출하려면 온라인으로 신청하세요.
차트 데이터 소스를 승격하려면 어떻게 해야 하나요?: 시각화 그룹에 구현 내용을 게시합니다. 마음에 들면 직접 언급할 수도 있습니다.