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. É possível criar gráficos GraphViz usando a linguagem DOT e os mecanismos de layout que você quiser.
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. Também é possível 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 diferentes 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. Consulte a referência da linguagem DOT (em inglês) no site do GraphViz. |
chd |
NÃO USADO | Uma peculiaridade dos códigos do GraphViz é que o parâmetro chd é ignorado. Não inclua essa informação no seu 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 mapa de imagem HTML, que pode ser usado para adicionar links ou interatividade ao gráfico. Consulte Como criar um mapa de imagem de gráfico para mais detalhes. |
callback=<handling_function_name> |
Opcional | Se você especificar chof=json , também poderá especificar uma função para chamar 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. Sua página pode especificar o gráfico como um elemento <img> para renderizar o gráfico e também chamar o mesmo URL com chof=json&callback=somefunc e incluir uma função chamada somefunc() , que 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 deve ser usado. Em vez dele, use o parâmetrochs
da API Chart. - O número máximo de nós é 200 e o máximo para bordas é 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 erro, se houver. - Os atributos
graph
ratio
,margin
epad
não têm suporte e serão ignorados se estiverem presentes.