Mudanças entre as edições de "Consulta:CrossMap"
(→Criando um CrossMap) |
m (Alguns erros de gramática que percebi lendo a página) |
||
(13 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 == | ||
− | Para criar um CrossMap, siga | + | [[Arquivo:Client CrossMap AddQuery.png|miniaturadaimagem|Botão para adicionar nova query]] |
− | * | + | [[Arquivo:Web CrossMap.png|miniaturadaimagem|CrossMap exibido no site]] |
+ | [[Arquivo:PostgreSQL mapdata result.png|miniaturadaimagem|Resultado do SQL]] | ||
+ | <div class="paragraph"> | ||
+ | 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 [//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: | ||
+ | * 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''. | ||
+ | * 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: | ||
+ | <syntaxhighlight lang="Sql">SELECT * | ||
+ | FROM mapdata | ||
+ | ORDER BY seq | ||
+ | </syntaxhighlight> | ||
+ | * 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: | ||
+ | <syntaxhighlight lang="Sql">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 | ||
+ | </syntaxhighlight> | ||
+ | * 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. | ||
+ | </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 16h21min 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
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 , que fica à esquerda da tela, e em seguida clique em . 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.