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

자주 묻는 질문(FAQ)

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

시작하기

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

API 사용

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

Chart API를 사용하면 데이터 및 차트 구성 옵션이 모두 포함된 서식 있는 URL을 Google 서버에 전송하여 다양한 종류의 이미지 차트를 만들 수 있습니다. Chart API에는 다양한 옵션이 있는 닫힌 차트 세트가 포함되어 있습니다. Chart API 데이터 세트는 URL 크기 (약 2K)로 제한됩니다.

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

시각화 API는 차트에 액세스하기 위한 자바스크립트 API를 제공합니다.
차트 갤러리에는 Google에서 만든 차트가 포함되어 있지만, 자체 시각화 API를 준수하는 시각화를 만들 수 있는 타사에도 개방되어 있습니다.
시각화 API 차트 및 차트는 브라우저에서 렌더링할 수 있는 것이면 무엇이든 가능합니다. 여기에는 이미지, 자바스크립트, 벡터 그래픽, 플래시 등이 포함됩니다.
대부분의 Chart API 차트는 시각화 API를 통해 액세스할 수 있지만 일부 구성 옵션은 사용하지 못할 수도 있습니다.
또한 API는 문서화된 유선 프로토콜 및 모든 사용자가 자신의 데이터 소스를 API 시각화에 노출할 수 있는 방법을 제공합니다.
이 API에는 차트에서 이벤트를 생성 및 수신하여 호스트 페이지 또는 페이지의 다른 차트와 통신할 수 있는 정의된 이벤트 모델이 있습니다.

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

Visualization 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 차트의 상호작용이 필요하지 않으면 차트의 스크린샷을 찍고 원하는 대로 사용할 수 있습니다.

문제 해결

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

먼저 자바스크립트 콘솔을 확인합니다. Chrome에서는 Chrome->뷰->개발자->자바스크립트 콘솔 또는 Chrome->도구->자바스크립트 콘솔을 통해 자바스크립트 콘솔에 액세스할 수 있습니다. 모든 최신 브라우저에는 자바스크립트 콘솔이 있습니다. 메뉴를 찾으려면 '고급' 또는 '개발자 도구'와 같은 이름으로 메뉴를 찾아야 할 수 있습니다.

콘솔을 통해 즉시 문제가 해결되기를 바랍니다. 하지만 콘솔 메시지를 근본 원인으로 번역하기 어려울 때도 있습니다. 일반적인 함정은 다음과 같습니다.

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을 포함하세요.

월과 일수를 1씩 줄이는 이유는 무엇인가요?

Google 차트는 0부터 시작하는 색인 생성을 사용하는 자바스크립트를 사용합니다. 월의 첫 번째 날은 0이며 월 범위는 0 (1월)에서 11 (12월)까지입니다. 코드에서 1부터 시작하는 색인 생성이 가정된다면 데이터를 빼서 자바스크립트 날짜 객체에 넣으세요.

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

브라우저 비호환성에 관한 정보는 caniuse.com을 참조하세요. Google 차트에서는 다음과 같은 두 가지 이유로 Internet Explorer 8 이하에서 문제가 발생하는 경우가 있습니다.

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

IE8의 자바스크립트에서는 목록에 후행 쉼표가 허용되지 않습니다.

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

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

Google 시각화 프로그램 정책

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

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

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

데이터를 수집하는 차트를 만드는 개발자는 법적으로 적합한 개인정보처리방침을 유지하고 연결하는 데 동의합니다. 또한 개발자에게 차트 보안 유지를 보장하고 차트 디렉터리에 상주하는 한 애플리케이션을 유지관리하도록 요구합니다.

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

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

예. 작은 글씨는 Google 시각화 API의 서비스 약관을 참고하세요.

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

현재는 시각화 API를 사용하여 클라이언트 측 소프트웨어를 만들 수 없습니다. 시각화 API는 제공된 인터페이스를 통해서만 사용할 수 있습니다. 작은 글씨는 Google Visualization API 서비스 약관을 참고하세요.

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

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

프로그램 정책 위반

이 프로그램 정책을 위반하면 차트 사용 중지 또는 삭제, 향후 차트 업로드 차단, Google 계정 해지 또는 모든 차트 삭제로 이어질 수 있습니다.

커뮤니티에서 활동하기

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