Esta página foi traduzida pela API Cloud Translation.

Class ScatterChartBuilder

Builder para gráficos de dispersão. Para mais detalhes, consulte a documentação do Google Charts.

Confira um exemplo que mostra como criar um gráfico de dispersão. Os dados são importados de uma planilha Google.

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

const chartBuilder = Charts.newScatterChart()
                         .setTitle('Adjusted GDP & U.S. Population')
                         .setXAxisTitle('U.S. Population (millions)')
                         .setYAxisTitle('Adjusted GDP ($ billions)')
                         .setDimensions(600, 500)
                         .setLegendPosition(Charts.Position.NONE)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Métodos

Método	Tipo de retorno	Breve descrição
`build()`	`Chart`	Cria o gráfico.
`setBackgroundColor(cssValue)`	`ScatterChartBuilder`	Define a cor de fundo do gráfico.
`setColors(cssValues)`	`ScatterChartBuilder`	Define as cores das linhas no gráfico.
`setDataSourceUrl(url)`	`ScatterChartBuilder`	Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google.
`setDataTable(tableBuilder)`	`ScatterChartBuilder`	Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder.
`setDataTable(table)`	`ScatterChartBuilder`	Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X.
`setDataViewDefinition(dataViewDefinition)`	`ScatterChartBuilder`	Define a definição de visualização de dados a ser usada no gráfico.
`setDimensions(width, height)`	`ScatterChartBuilder`	Define as dimensões do gráfico.
`setLegendPosition(position)`	`ScatterChartBuilder`	Define a posição da legenda em relação ao gráfico.
`setLegendTextStyle(textStyle)`	`ScatterChartBuilder`	Define o estilo de texto da legenda do gráfico.
`setOption(option, value)`	`ScatterChartBuilder`	Define opções avançadas para este gráfico.
`setPointStyle(style)`	`ScatterChartBuilder`	Define o estilo dos pontos na linha.
`setTitle(chartTitle)`	`ScatterChartBuilder`	Define o título do gráfico.
`setTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Define o estilo de texto do título do gráfico.
`setXAxisLogScale()`	`ScatterChartBuilder`	Transforma o eixo horizontal em uma escala logarítmica (exige que todos os valores sejam positivos).
`setXAxisRange(start, end)`	`ScatterChartBuilder`	Define o intervalo do eixo horizontal do gráfico.
`setXAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Define o estilo de texto do eixo horizontal.
`setXAxisTitle(title)`	`ScatterChartBuilder`	Adiciona um título ao eixo horizontal.
`setXAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Define o estilo do texto do título do eixo horizontal.
`setYAxisLogScale()`	`ScatterChartBuilder`	Transforma o eixo vertical em uma escala logarítmica (exige que todos os valores sejam positivos).
`setYAxisRange(start, end)`	`ScatterChartBuilder`	Define o intervalo do eixo vertical do gráfico.
`setYAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Define o estilo de texto do eixo vertical.
`setYAxisTitle(title)`	`ScatterChartBuilder`	Adiciona um título ao eixo vertical.
`setYAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Define o estilo do texto do título do eixo vertical.

Documentação detalhada

`build()`

Cria o gráfico.

Retornar

Chart: um objeto de gráfico, que pode ser incorporado a documentos, elementos da interface ou usado como uma imagem estática.

`setBackgroundColor(cssValue)`

Define a cor de fundo do gráfico.

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

Parâmetros

Nome	Tipo	Descrição
`cssValue`	`String`	O valor CSS da cor (como `"blue"` ou `"#00f"`).

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setColors(cssValues)`

Define as cores das linhas no gráfico.

// 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']);

Parâmetros

Nome	Tipo	Descrição
`cssValues`	`String[]`	Uma matriz de valores CSS de cor, como `["red", "#acf"]`. O elemento n na matriz representa a cor da linha n no gráfico.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setDataSourceUrl(url)`

Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. Se um URL da fonte de dados e uma DataTable forem fornecidos, o URL da fonte de dados será ignorado.

Para mais informações sobre como consultar fontes de dados, consulte a documentação do Google Charts.

Parâmetros

Nome	Tipo	Descrição
`url`	`String`	O URL da fonte de dados, incluindo os parâmetros de consulta.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setDataTable(tableBuilder)`

Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. Esse é um método conveniente para definir a tabela de dados sem precisar chamar build().

Parâmetros

Nome	Tipo	Descrição
`tableBuilder`	`DataTableBuilder`	Um criador de tabelas de dados. Uma nova tabela de dados é criada instantaneamente como parte dessa chamada, portanto, outras atualizações do builder não serão refletidas no gráfico.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setDataTable(table)`

Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. A primeira coluna precisa ser uma string e conter os rótulos do eixo horizontal. Qualquer número de colunas pode ser seguido, todas precisam ser numéricas. Cada coluna é mostrada como uma linha separada.

Parâmetros

Nome	Tipo	Descrição
`table`	`DataTableSource`	A tabela de dados a ser usada no gráfico.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setDataViewDefinition(dataViewDefinition)`

Define a definição de visualização de dados a ser usada no gráfico.

Parâmetros

Nome	Tipo	Descrição
`dataViewDefinition`	`DataViewDefinition`	Um objeto de definição de visualização de dados que define a visualização que precisa ser derivada da fonte de dados especificada para o desenho do gráfico.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setDimensions(width, height)`

Define as dimensões do gráfico.

Parâmetros

Nome	Tipo	Descrição
`width`	`Integer`	A largura do gráfico, em pixels.
`height`	`Integer`	A altura do gráfico, em pixels.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setLegendPosition(position)`

Define a posição da legenda em relação ao gráfico. Por padrão, não há legenda.

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

Parâmetros

Nome	Tipo	Descrição
`position`	`Position`	A posição da legenda.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setLegendTextStyle(textStyle)`

Define o estilo de texto da legenda do gráfico.

// 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);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado na legenda do gráfico.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setOption(option, value)`

Define opções avançadas para este gráfico. Consulte as opções disponíveis para este gráfico. Esse método não terá efeito se a opção for inválida.

// Build a scatter chart with a 1-second animation duration.
const builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Parâmetros

Nome	Tipo	Descrição
`option`	`String`	A opção a ser definida.
`value`	`Object`	O valor que será definido.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setPointStyle(style)`

Define o estilo dos pontos na linha. Por padrão, os pontos não têm estilos específicos, e apenas a linha fica visível.

// Creates a line chart builder and sets large point style.
const builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parâmetros

Nome	Tipo	Descrição
`style`	`PointStyle`	O estilo a ser usado para pontos na linha.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

Consulte também

PointStyle

`setTitle(chartTitle)`

Define o título do gráfico. O título é exibido centralizado acima do gráfico.

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

Parâmetros

Nome	Tipo	Descrição
`chartTitle`	`String`	o título do gráfico.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setTitleTextStyle(textStyle)`

Define o estilo de texto do título do gráfico.

// 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);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado para o título do gráfico. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setXAxisLogScale()`

Transforma o eixo horizontal em uma escala logarítmica (exige que todos os valores sejam positivos).

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setXAxisRange(start, end)`

Define o intervalo do eixo horizontal do gráfico.

Se algum ponto de dados estiver fora do intervalo, ele será expandido para incluir esses pontos.

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

Parâmetros

Nome	Tipo	Descrição
`start`	`Number`	O valor da linha de grade mais baixa do eixo horizontal.
`end`	`Number`	O valor da linha de grade mais alta do eixo horizontal.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setXAxisTextStyle(textStyle)`

Define o estilo de texto do eixo horizontal.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado para o título do eixo horizontal. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setXAxisTitle(title)`

Adiciona um título ao eixo horizontal. O título é centralizado e aparece abaixo dos rótulos de valor do eixo.

// Creates a line chart builder and sets the X-axis title.
const builder = Charts.newLineChart();
builder.setTitle('X-axis Title');

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	O título do eixo X.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setXAxisTitleTextStyle(textStyle)`

Define o estilo do texto do título do eixo horizontal.

// Creates a line chart builder and sets the X-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado para o título do eixo horizontal. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setYAxisLogScale()`

Transforma o eixo vertical em uma escala logarítmica (exige que todos os valores sejam positivos).

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setYAxisRange(start, end)`

Define o intervalo do eixo vertical do gráfico. Se algum ponto de dados estiver fora do intervalo, ele será expandido para incluir esses pontos.

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

Parâmetros

Nome	Tipo	Descrição
`start`	`Number`	O valor da linha de grade mais baixa do eixo vertical.
`end`	`Number`	O valor da linha de grade mais alta do eixo vertical.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setYAxisTextStyle(textStyle)`

Define o estilo de texto do eixo vertical.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado para o título do eixo horizontal. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setYAxisTitle(title)`

Adiciona um título ao eixo vertical. O título é centralizado e aparece à esquerda dos rótulos de valor.

// Creates a line chart builder and sets the Y-axis title.
const builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title');

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	O título do eixo Y.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.

`setYAxisTitleTextStyle(textStyle)`

Define o estilo do texto do título do eixo vertical.

// Creates a line chart builder and sets the Y-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado para o título do eixo horizontal. É possível criar um objeto `TextStyleBuilder` chamando `Charts.newTextStyle()`.

Retornar

ScatterChartBuilder: esse builder é útil para encadeamento.