Class ScatterChartBuilder

ScatterChartBuilder

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

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

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

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

var chart = chartBuilder.build();

Métodos

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


setBackgroundColor(cssValue)

Define a cor do plano de fundo do gráfico.

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

Parâmetros

NomeTipoDescrição
cssValueStringO valor de CSS para a cor (como "blue" ou "#00f").

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parâmetros

NomeTipoDescrição
cssValuesString[]Uma matriz de valores CSS de cor, como ["red", "#acf"]. O enésimo elemento na matriz representa a cor da enésima linha no gráfico.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setDataSourceUrl(url)

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

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

Parâmetros

NomeTipoDescrição
urlStringO URL da fonte de dados, incluindo quaisquer parâmetros de consulta.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setDataTable(tableBuilder)

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

Parâmetros

NomeTipoDescrição
tableBuilderDataTableBuilderUm criador de tabela de dados. Uma nova tabela de dados é criada instantaneamente como parte para que outras atualizações do builder não sejam refletidas no gráfico.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setDataTable(table)

Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. A deve ser uma string e conter os rótulos do eixo horizontal. Qualquer número de colunas que podem ser seguidas, todos devem ser numéricos. Cada coluna é exibida como uma linha separada.

Parâmetros

NomeTipoDescrição
tableDataTableSourceA tabela de dados a ser usada no gráfico.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setDataViewDefinition(dataViewDefinition)

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

Parâmetros

NomeTipoDescrição
dataViewDefinitionDataViewDefinitionUm objeto de definição de visualização de dados que define a visualização que deve ser da fonte de dados para o desenho do gráfico.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setDimensions(width, height)

Define as dimensões do gráfico.

Parâmetros

NomeTipoDescrição
widthIntegerA largura do gráfico, em pixels.
heightIntegerA altura do gráfico, em pixels.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setLegendPosition(position)

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

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

Parâmetros

NomeTipoDescrição
positionPositionA posição da legenda.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setLegendTextStyle(textStyle)

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

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado para a legenda do gráfico.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setOption(option, value)

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

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

Parâmetros

NomeTipoDescrição
optionStringA opção a ser definida.
valueObjectO valor que será definido.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setPointStyle(style)

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

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

Parâmetros

NomeTipoDescrição
stylePointStyleO estilo a ser usado para pontos na linha.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.

Consulte também


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'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parâmetros

NomeTipoDescrição
chartTitleStringo título do gráfico.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


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.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do gráfico. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setXAxisLogScale()

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

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setXAxisRange(start, end)

Define o intervalo do eixo horizontal do gráfico.

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

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

Parâmetros

NomeTipoDescrição
startNumberO valor da linha de grade mais baixa do eixo horizontal.
endNumberO valor da linha de grade mais alta do eixo horizontal.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setXAxisTextStyle(textStyle)

Define o estilo do texto do eixo horizontal.

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setXAxisTitle(title)

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

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

Parâmetros

NomeTipoDescrição
titleStringO título do eixo X.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setYAxisLogScale()

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

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setYAxisRange(start, end)

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

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

Parâmetros

NomeTipoDescrição
startNumberO valor da linha de grade mais baixa do eixo vertical.
endNumberO valor da linha de grade mais alta do eixo vertical.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setYAxisTextStyle(textStyle)

Define o estilo do texto do eixo vertical.

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


setYAxisTitle(title)

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

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

Parâmetros

NomeTipoDescrição
titleStringTítulo do eixo Y.

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.


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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retornar

ScatterChartBuilder: esse builder, útil para encadeamentos.