Este documento descreve como criar gráficos GraphViz usando a API de gráficos do Google.
Visão geral
O GraphViz é um pacote de ferramentas de código aberto para a visualização de gráficos de conectividade. Você pode criar gráficos GraphViz usando a linguagem DOT e os mecanismos de layout de sua escolha.
Os gráficos GraphViz suportam um conjunto diferente de parâmetros obrigatórios. Veja os parâmetros compatíveis:
Parâmetro | Obrigatório ou opcional | Descrição |
---|---|---|
cht=gv[:<opt_engine>] |
Obrigatório | Especifica um gráfico GraphViz. Opcionalmente, você pode especificar um mecanismo GraphViz. Se você quiser especificar um mecanismo de layout, inclua o ponto e vírgula : e especifique uma das seguintes strings para <opt_engine>:
Consulte o site do GraphViz para ver uma descrição desses mecanismos. |
chs=<width>x<height> |
Opcional | Se você não especificar um tamanho, o gráfico será dimensionado automaticamente. |
chl=<DOT_string> |
Obrigatório | O gráfico a ser desenhado, na notação da linguagem DOT. Você pode encontrar a referência da linguagem DOT no site do GraphViz. |
chd |
NÃO USADO | Uma peculiaridade dos códigos do GraphViz é que o parâmetro chd é ignorado. Não o inclua no URL. |
chof=<output_format> |
Opcional | Um formato de saída para o gráfico. Consulte a descrição do parâmetro para saber quais formatos de saída são compatíveis. Se você especificar chof=json , vai receber uma representação JSON do gráfico como um mapa de imagem HTML que pode ser usado para adicionar links ou interatividade ao gráfico. Consulte Criar um mapa de imagem do gráfico para mais detalhes. |
callback=<handling_function_name> |
Opcional | Se você especificar chof=json , também poderá especificar uma função a ser chamada com o JSON retornado, que inclui o mapa de imagem do gráfico.
A função precisa aceitar um único parâmetro JSON, que será uma representação JSON do gráfico. Em seguida, a página pode especificar o gráfico como um elemento <img> para renderizar o gráfico, além de chamar o mesmo URL com chof=json&callback=somefunc e incluir uma função chamada somefunc() , que vai analisar o JSON retornado e adicionar links ou interatividade. |
Exemplos:
Descrição | Exemplo |
---|---|
exemplo de mecanismo dot (padrão). |
|
exemplo de mecanismo neato do mesmo gráfico. | cht=gv:neato |
Um gráfico dot, sem especificação de tamanho. O gráfico é dimensionado automaticamente. | cht=gv |
Um gráfico mais complexo. | cht=gv |
Veja algumas dicas e limitações conhecidas dos gráficos GraphVize:
- O atributo
graph
size
não pode ser usado. Utilize o parâmetrochs
da API de gráficos. - O número máximo de nós é 200, e o máximo para arestas é 400.
- Fontes alternativas, com suavização de serrilhado e transparência não são suportadas.
- Os atributos
node
image
eshapefile
não são compatíveis e resultarão em um erro se estiverem presentes. - Os atributos
graph
ratio
,margin
epad
não são compatíveis e serão ignorados se estiverem presentes.