Mudanças entre as edições de "Consulta:CrossMap"

De LATROMI Manuais
Ir para: navegação, pesquisa
(Criando um CrossMap)
m (Alguns erros de gramática que percebi lendo a página)
 
(4 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
 
'''CrossMap''' é um dos vários tipos de saída que uma [[Consulta:Visão_Geral|Consulta]] pode ter. Eles são formados pela combinação de coordenadas formatadas de diferentes formas, e exibidas em único elemento '''Google Map'''.
 
'''CrossMap''' é um dos vários tipos de saída que uma [[Consulta:Visão_Geral|Consulta]] pode ter. Eles são formados pela combinação de coordenadas formatadas de diferentes formas, e exibidas em único elemento '''Google Map'''.
 +
 +
== Requisitos ==
 +
Para utilizar o CrossMap, você precisa primeiro possuir uma Chave de API do Google Maps. Para mais informações, acesse: [[Integrações:Google_Maps|Integração com o Google Maps]].
  
 
== Criando um CrossMap ==
 
== Criando um CrossMap ==
Linha 8: Linha 11:
 
Para criar um CrossMap é necessário informar uma ou mais Queries, as quais devem retornar as coordenadas e o nome dos locais (uma coordenada por linha).
 
Para criar um CrossMap é necessário informar uma ou mais Queries, as quais devem retornar as coordenadas e o nome dos locais (uma coordenada por linha).
  
A possibilidade de poder dividir a busca das coordenadas em mais de uma Query é muito útil. Por exemplo, uma Query pode retornar coordenadas que compões um '''Trajeto''' e outra Query pode trazer as coordenadas dos pontos de '''origem''' e '''destino'''. Veja abaixo como seria a criação de um CrossMap como esse:
+
A possibilidade de poder dividir a busca das coordenadas em mais de uma Query é muito útil. Por exemplo, uma Query pode retornar coordenadas que compõem um '''Trajeto''' e outra Query pode trazer as coordenadas dos pontos de '''origem''' e '''destino'''. Veja abaixo como seria a criação de um CrossMap como esse:
  
 
Primeiramente, baixe o [//latromi.com.br/downloads/wikifiles/sql/mapdata.sql arquivo Sql de exemplo], e execute em um banco de dados que você possa usar para testes. Este arquivo cria a tabela '''mapdata''', com informações de um trajeto que vai da '''Arena do Grêmio''' até o '''Estádio Beira Rio''' em Porto Alegre.  
 
Primeiramente, baixe o [//latromi.com.br/downloads/wikifiles/sql/mapdata.sql arquivo Sql de exemplo], e execute em um banco de dados que você possa usar para testes. Este arquivo cria a tabela '''mapdata''', com informações de um trajeto que vai da '''Arena do Grêmio''' até o '''Estádio Beira Rio''' em Porto Alegre.  
  
 
Agora, siga passos a seguir para adicionar a primeira Query:
 
Agora, siga passos a seguir para adicionar a primeira Query:
* No Cadastro de Consultas, clique no ícone [[Arquivo:Client Consulta Buttons AddQuery.png]], que fica a esquerda da tela, e em seguida clique em [[Arquivo:Client_Consulta_Buttons_AddCrossMap.png]]. A tela de edição de Queries será exibida.
+
* No Cadastro de Consultas, clique no ícone [[Arquivo:Client Consulta Buttons AddQuery.png]], que fica à esquerda da tela, e em seguida clique em [[Arquivo:Client_Consulta_Buttons_AddCrossMap.png]]. A tela de edição de Queries será exibida.
 
* Preencha o campo '''Nome''' sem usar espaços ou caracteres especiais. Por exemplo, ''crossMap''.
 
* Preencha o campo '''Nome''' sem usar espaços ou caracteres especiais. Por exemplo, ''crossMap''.
 
* Selecione um valor para o '''Nível de Zoom''' que será usado no mapa.
 
* Selecione um valor para o '''Nível de Zoom''' que será usado no mapa.
Linha 22: Linha 25:
 
ORDER BY seq
 
ORDER BY seq
 
</syntaxhighlight>
 
</syntaxhighlight>
* Na aba '''Configurações''', selecione o '''Tipo''' "Trajeto", e informe a '''Cor da Linha'''.
+
* Clique na aba '''Configurações''', e selecione o '''Tipo''' "Trajeto", e informe a '''Cor da Linha'''.
  
Agora vamos adicionar a segunda Query, que vai retornar os pontos de Origem e Destino do Trajeto:
+
Agora vamos adicionar a segunda Query, que vai retornar os pontos de '''Origem''' e '''Destino''' do Trajeto:
 
* Clique no botão '''+''' para adicionar uma nova '''Query'''
 
* Clique no botão '''+''' para adicionar uma nova '''Query'''
 
* Na aba '''Comando SQL''', Informe a query abaixo:
 
* Na aba '''Comando SQL''', Informe a query abaixo:
Linha 34: Linha 37:
 
ORDER BY seq
 
ORDER BY seq
 
</syntaxhighlight>
 
</syntaxhighlight>
* Na aba '''Configurações''', selecione o '''Tipo''' "Marcador Imagem", e selecione uma imagem para ser exibida em cada Coordenada.
+
* Clique na aba '''Configurações''', selecione o '''Tipo''' "Marcador Imagem" e selecione uma imagem para ser exibida em cada Coordenada.
* Clique em '''OK''' para confirmar o Comando SQL. O sistema solicitará um "De/Para" entre as colunas que são retornadas do Comando SQL e as Colunas necessárias para montar o Gráfico.
+
* Clique em '''OK''' para confirmar os Comandos SQL. O sistema solicitará um "De/Para" entre as colunas que são retornadas do Comando SQL e as Colunas necessárias para montar o Mapa.
* Em seguida, o Comando SQL será executado no banco de dados para fins de validação. Se houver erro, será necessário corrigir.
+
* Em seguida, os Comandos SQL serão executados no banco de dados para fins de validação. Se houver erro, será necessário corrigir.
* Agora de volta a tela principal da Consulta, perceba que as colunas retornadas no comando SELECT foram criadas na sessão de Configurações de Colunas. Para finalizar clique no menu Arquivo → Salvar.
+
* Agora de volta à tela principal da Consulta, clique no menu Arquivo → Salvar.
 
</div>
 
</div>
 +
 +
<youtube>https://www.youtube.com/embed/UlP6JHMBBcI</youtube>
 +
 +
== Ver Também ==
 +
* [[Integrações:Google_Maps|Integração com o Google Maps]]

Edição atual tal como às 17h21min de 5 de fevereiro de 2020

CrossMap é um dos vários tipos de saída que uma Consulta pode ter. Eles são formados pela combinação de coordenadas formatadas de diferentes formas, e exibidas em único elemento Google Map.

Requisitos

Para utilizar o CrossMap, você precisa primeiro possuir uma Chave de API do Google Maps. Para mais informações, acesse: Integração com o Google Maps.

Criando um CrossMap

Botão para adicionar nova query
CrossMap exibido no site
Resultado do SQL

Para criar um CrossMap é necessário informar uma ou mais Queries, as quais devem retornar as coordenadas e o nome dos locais (uma coordenada por linha).

A possibilidade de poder dividir a busca das coordenadas em mais de uma Query é muito útil. Por exemplo, uma Query pode retornar coordenadas que compõem um Trajeto e outra Query pode trazer as coordenadas dos pontos de origem e destino. Veja abaixo como seria a criação de um CrossMap como esse:

Primeiramente, baixe o arquivo Sql de exemplo, e execute em um banco de dados que você possa usar para testes. Este arquivo cria a tabela mapdata, com informações de um trajeto que vai da Arena do Grêmio até o Estádio Beira Rio em Porto Alegre.

Agora, siga passos a seguir para adicionar a primeira Query:

  • No Cadastro de Consultas, clique no ícone Client Consulta Buttons AddQuery.png, que fica à esquerda da tela, e em seguida clique em Client Consulta Buttons AddCrossMap.png. A tela de edição de Queries será exibida.
  • Preencha o campo Nome sem usar espaços ou caracteres especiais. Por exemplo, crossMap.
  • Selecione um valor para o Nível de Zoom que será usado no mapa.
  • No campo Descrição informe um texto que identifique a sua Query.
  • Na aba Comando SQL, Informe a query abaixo:
SELECT * 
FROM mapdata
ORDER BY seq
  • Clique na aba Configurações, e selecione o Tipo "Trajeto", e informe a Cor da Linha.

Agora vamos adicionar a segunda Query, que vai retornar os pontos de Origem e Destino do Trajeto:

  • Clique no botão + para adicionar uma nova Query
  • Na aba Comando SQL, Informe a query abaixo:
SELECT * 
FROM mapdata
-- Só irá trazer o primeiro e o último registro, 
-- pois são os únicos com descrição informada.
WHERE description IS NOT NULL 
ORDER BY seq
  • Clique na aba Configurações, selecione o Tipo "Marcador Imagem" e selecione uma imagem para ser exibida em cada Coordenada.
  • Clique em OK para confirmar os Comandos SQL. O sistema solicitará um "De/Para" entre as colunas que são retornadas do Comando SQL e as Colunas necessárias para montar o Mapa.
  • Em seguida, os Comandos SQL serão executados no banco de dados para fins de validação. Se houver erro, será necessário corrigir.
  • Agora de volta à tela principal da Consulta, clique no menu Arquivo → Salvar.

Ver Também