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

Class PieChartBuilder

원형 차트의 빌더입니다. 자세한 내용은 Google 차트 문서를 참고하세요.

다음은 원형 차트를 만드는 방법을 보여주는 예입니다. 데이터는 Google 스프레드시트에서 가져옵니다.

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AB8' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

const chartBuilder = Charts.newPieChart()
                         .setTitle('World Population by Continent')
                         .setDimensions(600, 500)
                         .set3D()
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

메서드

메서드	반환 유형	간략한 설명
`build()`	`Chart`	차트를 빌드합니다.
`reverseCategories()`	`PieChartBuilder`	도메인 축에서 계열의 그리기를 반대로 합니다.
`set3D()`	`PieChartBuilder`	차트를 3차원으로 설정합니다.
`setBackgroundColor(cssValue)`	`PieChartBuilder`	차트의 배경 색상을 설정합니다.
`setColors(cssValues)`	`PieChartBuilder`	차트의 선 색상을 설정합니다.
`setDataSourceUrl(url)`	`PieChartBuilder`	Google Sheets와 같은 외부 소스에서 데이터를 가져오는 데 사용되는 데이터 소스 URL을 설정합니다.
`setDataTable(tableBuilder)`	`PieChartBuilder`	DataTableBuilder를 사용하여 차트에 사용할 데이터 테이블을 설정합니다.
`setDataTable(table)`	`PieChartBuilder`	차트의 선과 X축 라벨이 포함된 데이터 표를 설정합니다.
`setDataViewDefinition(dataViewDefinition)`	`PieChartBuilder`	차트에 사용할 데이터 보기 정의를 설정합니다.
`setDimensions(width, height)`	`PieChartBuilder`	차트의 측정기준을 설정합니다.
`setLegendPosition(position)`	`PieChartBuilder`	차트를 기준으로 범례의 위치를 설정합니다.
`setLegendTextStyle(textStyle)`	`PieChartBuilder`	차트 범례의 텍스트 스타일을 설정합니다.
`setOption(option, value)`	`PieChartBuilder`	이 차트의 고급 옵션을 설정합니다.
`setTitle(chartTitle)`	`PieChartBuilder`	차트 제목을 설정합니다.
`setTitleTextStyle(textStyle)`	`PieChartBuilder`	차트 제목의 텍스트 스타일을 설정합니다.

자세한 문서

`build()`

차트를 빌드합니다.

리턴

Chart: 문서, UI 요소에 삽입하거나 정적 이미지로 사용할 수 있는 차트 객체입니다.

`reverseCategories()`

도메인 축에서 계열의 그리기를 반대로 합니다. 세로 범위 차트 (예: 선, 영역 또는 열 차트)의 경우 수평축이 오른쪽에서 왼쪽으로 그려집니다. 수평 범위 차트 (예: 막대 그래프)의 경우 세로축이 위에서 아래로 그려집니다. 원형 차트의 경우 슬라이스가 시계 반대 방향으로 그려집니다.

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`set3D()`

차트를 3차원으로 설정합니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setBackgroundColor(cssValue)`

차트의 배경 색상을 설정합니다.

// Creates a line chart builder and sets the background color to gray
const builder = Charts.newLineChart();
builder.setBackgroundColor('gray');

매개변수

이름	유형	설명
`cssValue`	`String`	색상의 CSS 값 (예: `"blue"` 또는 `"#00f"`)입니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setColors(cssValues)`

차트의 선 색상을 설정합니다.

// Creates a line chart builder and sets the first two lines to be drawn in
// green and red, respectively.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

매개변수

이름	유형	설명
`cssValues`	`String[]`	색상 CSS 값 배열(예: `["red", "#acf"]`) 배열의 n번째 요소는 차트의 n번째 선의 색상을 나타냅니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setDataSourceUrl(url)`

Google Sheets와 같은 외부 소스에서 데이터를 가져오는 데 사용되는 데이터 소스 URL을 설정합니다. 데이터 소스 URL과 DataTable이 제공되는 경우 데이터 소스 URL은 무시됩니다.

데이터 소스 쿼리에 관한 자세한 내용은 Google 차트 문서를 참고하세요.

매개변수

이름	유형	설명
`url`	`String`	쿼리 매개변수를 포함한 데이터 소스 URL입니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setDataTable(tableBuilder)`

DataTableBuilder를 사용하여 차트에 사용할 데이터 테이블을 설정합니다. build()를 호출하지 않고 데이터 표를 설정하기 위한 편의 메서드입니다.

매개변수

이름	유형	설명
`tableBuilder`	`DataTableBuilder`	데이터 테이블 빌더입니다. 이 호출의 일부로 새 데이터 테이블이 즉시 생성되므로 빌더에 대한 추가 업데이트는 차트에 반영되지 않습니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setDataTable(table)`

차트의 선과 X축 라벨이 포함된 데이터 표를 설정합니다. 첫 번째 열은 문자열이어야 하며 가로축 라벨을 포함해야 합니다. 그 뒤에 오는 열의 수는 임의이며 모두 숫자여야 합니다. 각 열은 별도의 선으로 표시됩니다.

매개변수

이름	유형	설명
`table`	`DataTableSource`	차트에 사용할 데이터 표입니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setDataViewDefinition(dataViewDefinition)`

차트에 사용할 데이터 보기 정의를 설정합니다.

매개변수

이름	유형	설명
`dataViewDefinition`	`DataViewDefinition`	차트 그리기의 지정된 데이터 소스에서 파생되어야 하는 뷰를 정의하는 데이터 뷰 정의 객체입니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setDimensions(width, height)`

차트의 측정기준을 설정합니다.

매개변수

이름	유형	설명
`width`	`Integer`	차트의 너비(픽셀)입니다.
`height`	`Integer`	차트의 높이(픽셀)입니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setLegendPosition(position)`

차트를 기준으로 범례의 위치를 설정합니다. 기본적으로 범례는 표시되지 않습니다.

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

매개변수

이름	유형	설명
`position`	`Position`	범례의 위치입니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setLegendTextStyle(textStyle)`

차트 범례의 텍스트 스타일을 설정합니다.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

매개변수

이름	유형	설명
`textStyle`	`TextStyle`	차트 범례에 사용할 텍스트 스타일입니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setOption(option, value)`

이 차트의 고급 옵션을 설정합니다. 이 차트에 사용할 수 있는 옵션을 참고하세요. 지정된 옵션이 유효하지 않으면 이 메서드는 영향을 미치지 않습니다.

// Build a pie chart with a pretty legend.
const builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
const chart = builder.build();

매개변수

이름	유형	설명
`option`	`String`	설정할 옵션입니다.
`value`	`Object`	설정할 값입니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setTitle(chartTitle)`

차트 제목을 설정합니다. 제목은 차트 위에 가운데에 표시됩니다.

// Creates a line chart builder and title to 'My Line Chart'.
const builder = Charts.newLineChart();
builder.setTitle('My Line Chart');

매개변수

이름	유형	설명
`chartTitle`	`String`	차트 제목

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.

`setTitleTextStyle(textStyle)`

차트 제목의 텍스트 스타일을 설정합니다.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

매개변수

이름	유형	설명
`textStyle`	`TextStyle`	차트 제목에 사용할 텍스트 스타일입니다. `Charts.newTextStyle()`를 호출하여 `TextStyleBuilder` 객체를 만들 수 있습니다.

리턴

PieChartBuilder: 체이닝에 유용한 빌더입니다.