Mudanças entre as edições de "Consulta:CrossMap"
m (Alguns erros de gramática que percebi lendo a página) |
|||
(8 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 == | ||
+ | [[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"> | <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). | 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 | + | 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. | |
− | * No Cadastro de Consultas, clique no ícone [[Arquivo:Client Consulta Buttons AddQuery.png]], que fica | ||
* 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. | ||
+ | * No campo '''Descrição''' informe um texto que identifique a sua Query. | ||
* Na aba '''Comando SQL''', Informe a query abaixo: | * Na aba '''Comando SQL''', Informe a query abaixo: | ||
<syntaxhighlight lang="Sql">SELECT * | <syntaxhighlight lang="Sql">SELECT * | ||
Linha 17: | Linha 25: | ||
ORDER BY seq | ORDER BY seq | ||
</syntaxhighlight> | </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: | |
− | 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 30: | Linha 37: | ||
ORDER BY seq | ORDER BY seq | ||
</syntaxhighlight> | </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 | + | * 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, | + | * 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 | + | * 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
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.