| Indíce do artigo |
|---|
| Geopt.org Geocaching Tools - User Manual |
| English Version |
| Version Française |
| Deutsche Version |
| Todas as páginas |
Geopt.org Geocaching Tools - Manual de Utilização
(v 0.4.2.0) - 25 abril 2012
O portal GeoPT criou uma ferramenta com um interface simples e amigável que permite, em poucos minutos, efetuar várias operações automatizadas sobre o site geocaching.com, especificamente na área do utilizador, tais como, carregamento de imagens para os registos, registos automáticos de movimento de trackables, carregamento e personalização de fieldnotes e criação automática de Pocket Querys.
Instalação
A instalação é simples e apenas requer algumas indicações por parte do utilizador. Pode ser instalada para um utilizador do computador ou para todos.
A aplicação tem como requisito o produto Microsoft .NET Framework 4.0, mas se o mesmo não se encontrar instalado no computador, a aplicação informa e indica o endereço para o descarregar.
Primeira utilização - Autenticação e Autorização
Na primeira utilização é necessário efetuar a autenticação junto do geocaching.com, carregando em "Autenticar e Autorizar".
No entanto, mesmo sem autenticação, é possível utilizar os acessos às ferramentas online do portal Geopt.org, "Ferramentas Online".
A autenticação e autorização são efetuadas seguindo os três passos apresentados no écran "Autenticação":
Carregar em "Get Authorization"
Introduzir os dados de utilizador no geocaching.com, nome utilizador e palavra-passe, ou, em alternativa, usar o sistema de autenticação através do Facebook
Carregar em "Allow Access"
Após este processo a aplicação disponibilizará as ferramentas e em futuras utilizações não será necessário voltar a autenticar e autorizar, ficando a aplicação com o seguinte aspeto:
Linguagem
A aplicação pode ser utilizada em diferentes línguas, e de momento estão disponíveis a inglesa, a francesa e a portuguesa.
Atualização
Caso haja alguma versão mais atualizada que aquela que se está a utilizar, surgirá na parte inferior do écran, uma informação com o link para que se possa fazer o upgrade automaticamente.
Donativos e Links
Existe a possibilidade, através da caixa de seleção "Links", de remover os textos automáticos incluídos nos logs e fotos se for efetuado um donativo a geopt.org a partir da aplicação. O Donativo deve ser feito através do botão "Donativo ao Geopt.org".
Existe também disponível um link para o manual de utilização da ferramenta (este manual).
Utilização das ferramentas
Ferramentas www.geopt.org Online
As ferramentas online do portal Geopt.org são acedidas através dos botões disponíveis e a utilização de cada ferramenta está explicada nas respetivas páginas do portal.
Neste momento estão disponíveis as ferramentas "Gerador de Listings" e "Gerador de FTF".
Ferramentas API
Registo Automático de Field Notes
Vários são os equipamentos e as aplicações que disponibilizam a funcionalidade de Field Notes.
Durante uma ou várias jornadas de geocaching pode-se ir gravando informação relativa às caches que se vão encontrando (ou não encontrando) no aparelho/aplicação de GPS, geralmente em modo offline (desligado da Internet). Estamos a registar notas de campo - as chamadas Field Notes.
Encontra-se uma, marca-se como "Found". Deteta-se uma cache a precisar de logbook, marca-se como "Needs Maintenance". Podem-se registar "Notes" e eventualmente outros tipos de registo, tudo dependendo da aplicação ou aparelho GPS que for usado.
Terminada a jornada de geocaching todas as notas de campo estarão disponíveis no aparelho em modo de ficheiro, normalmente denominado "geocache_visits.txt" ou "FieldNotes.txt", etc.
Nota: Para saber como aceder e utilizar este ficheiro através do aparelho deverão ser consultados os respetivos manuais de utilização.
Os ficheiros podem ser carregados para o site geocaching.com, na página , através da opção Upload my Field Notes, onde ficam então disponíveis para serem editados e registados como Logs, um a um.
Com a ferramenta "Field Notes Upload/Registo Automático de Field Notes" disponibilizada pela aplicação "Geopt.org Geocaching Tools" é possível editar, parametrizar e personalizar as notas de campo, bem como, se se pretender, efetuar os logs online, e de um modo completamente autónomo e automático no site geocaching.com.
Carregar o ficheiro de Field Notes
Adicionar Logs manualmente
É possível adicionar registos de logs que eventualmente não tenham sido registados como nota de campo na aplicação ou aparelho de GPS, bastando carregar no botão "Novo" e preenchendo corretamente os quatro campos disponíveis na caixa Adicionar Log: o código da cache (gccode), o tipo de log, a data e hora do registo e o texto pretendido para o Log. Carregar no botão "Confirmar".
No campo de texto podem ser utilizados parâmetros de edição avançada, tais como tamanho e cor da fonte, estilos da fonte e inserção de endereços internet. Para esta opção estar disponível terá que estar selecionada a caixa "Usar Editor Avançado?". Pode ser limpo todo o texto e respetiva formatação (se usada), carregando no botão "Limpar".
Este processo poderá ser utilizado por todos os utilizadores que não disponham de nenhum dispositivo capaz de gerar o referido ficheiro, bastando para isso adicionar todos os pontos registados manualmente utilizando esta opção.
Nota: Caso exista ficheiro Field Notes para carregar, os registos adicionados manualmente só podem ser carregados após se efetuar o "Import Fieldnotes". Caso inverta esta ordem, os registos manuais serão apagados.
Alterar linhas de Logs
Podem alterar-se linhas, bastando para tal pressionar o botão "Editar" na ferramenta. Esta opção poderá ser bastante útil por exemplo para mudar o tipo de log, texto ou até a data.
Apagar linhas de Logs
Caso pretenda apagar todas as linhas, basta pressionar o botão "Limpar".
Personalizar Log
A personalização dos Logs é efetuada através dos campos disponíveis na parte inferior do écran da ferramenta, e atua sobre todos os registos disponíveis na grelha:
- Prefixo: Texto, que pode incluir várias linhas, incluindo parágrafos, a aparecer antes do texto pré-definido na nota de campo original.
- Incluir Nr de Found?: Texto com indicação do nº de Found do geocacher, a exibir no início do Log. Como a numeração dos Logs é efetuada com base no número de founds do geocacher, este parâmetro pode ser alterado de modo a permitir ao utilizador carregar fieldnotes que não sigam a sequência dos seus founds (por ex: quando já existam outras fieldnotes previamente carregadas).
- Incluir Data?: Texto com indicação da data do Log do geocacher, a exibir no início do Log, a seguir nº de Found (se incluído).
- Incluir Hora?: Texto com indicação da hora do Log do geocacher, a exibir no início do Log, a seguir nº de Found e da data do Log (se incluídos).
- Depois de...: Dá a indicação para excluir as Fn já enviadas anteriormente.
Nota: Tanto a data como a hora são calculadas através do registo de field note, nos campos disponíveis no ficheiro Field Notes original.
A verificação do texto e dos parâmetros introduzidos é efetuada através da coluna "Texto do Log", automaticamente após alteração de qualquer dos parâmetros. Podem-se alterar os textos e os parâmetros quantas vezes as que se pretenderem.
Os textos de Sufixo e Prefixo são gravados mesmo depois da aplicação ser encerrada, para poderem ser utilizados sempre que se pretender. Isto poderá ser útil para utilizar o sufixo para uma assinatura por exemplo.
Para ajudar na composição dos logs é disponibilizado um link para o listing da cache em questão, e uma coluna onde é também representado o tipo de log que estamos prestes a submeter.
Favoritos
Para cada registo da grelha, pode-se escolher se a cache é Favorita ou não, através da caixa de seleção da coluna "Favorito?", sendo esta opção apenas exequível no caso de se pretender efetuar os registos de Log Online.
A ferramenta disponibiliza dois métodos para envio de Field Notes para o geocaching.com, como Field Notes, ou como um Log Online.
Enviar Fieldnotes
Para ajudar à gestão do envio de fieldnotes, e de modo a evitar envio de registos repetidos para o site, está disponível a opção "Depois de..." que filtra os registos e apresenta apenas os que ainda não foram submetidos.
Logar tudo Online
Assim, como sempre todos sonhamos.
Envio Automático de Fotos
O écran principal da ferramenta de carregamento de fotografias é composto por várias linhas, correspondentes aos últimos Logs do utilizador, que são carregados quando o écran é iniciado, ou quando se escolhe o botão "Atualizar Logs".
Para os geocachers portugueses é dada a opção de carregar os logs via IAAN do geopt.org ou diretamente do site geocaching.com. A diferença é que a primeira opção, através do IAAN, dá a possibilidade de filtrar os logs por um determinado período de datas e a segunda não, permitindo esta no entanto ir carregando consecutivamente logs à medida que se carregue no botão "Obter mais Logs".
Ao iniciar esta aplicação (para a opção de Logs carregados via IAAN), o filtro de datas é definido automaticamente para os últimos trinta dias, disponibilizando um máximo de 200 logs. O filtro pode ser definido de modo a obter o período de tempo necessário para o carregamento das fotos pretendidas, evitando muitos registos no écran da aplicação, facilitando a tarefa ao utilizador.
Carregamento de Imagens
Para cada Log onde se pretenda acrescentar imagens:
1. Carregar no botão "Gerir Imagens".
1.a) No écran de gestão de imagens carregar em "Adicionar Imagens" e na caixa de seleção de imagens que aparecerá escolher uma ou várias fotografias de uma pasta localizada no computador.
1.b) Na caixa do lado esquerdo, com a lista de fotos disponíveis, clicando com o rato numa determinada foto, é mostrada uma pré-visualização da mesma, do lado direito, para melhor perceção das fotos que se pretende adicionar ao log.
1.c) Selecionando as fotos com um visto, as mesmas podem ser removidas pressionando o botão "Remover Imagens".
1.d) Podem ser removidas todas as imagens carregando no botão "Apagar Todas".
1.e) O botão "Cancelar" cancelará todas as alterações efetuadas em "Gerir Imagens".
1.f) Carregando em "Confirmar", todas as imagens da listagem ficarão disponíveis para carregamento no log.
1.g) Podem ser editados tanto o Título como a Descrição da imagem selecionada, nas duas caixas por baixo da pre-visualização da mesma.
2. Escrever o titulo para as imagens no campo "Prefixo do nome", pois as fotos a carregar em cada Log terão como título o texto definido neste campo seguido de um número sequencial. Poderá ser usada a numeração romana se se preencher a caixa de seleção "Numeração Romana?". Caso não se preencha o campo "Prefixo do nome" será assumido o nome do ficheiro da imagem para o título da foto no site geocaching.com, ou os nomes definidos pelo utilizador para cada foto, caso se tenha preenchido os campos "Titulo" e "Descrição" (ponto 1.g). O tamanho das fotos a enviar para o geocaching.com pode ser definido na caixa "max" que por pré-definição se encontra no tamanho de 1024 pixeis. De notar que em futuras utilizações, a aplicação lembrar-se-á do tamanho das imagens escolhido pelo utilizador.
3. Depois de todas as fotos selecionadas, carregar em "Upload todas as Imagens" no canto inferior direito, e aguardar comodamente pelo carregamento das imagens nos respetivos logs, podendo ser observado o seu estado nas colunas "Status" e "Progresso".
Quando o processo termina é despoletada uma caixa com a mensagem "Upload Complete" para o écran.
Assim. Simples.
Apagar linhas de Logs
De modo a facilitar a visualização de registos, ou corrigir eventuais lapsos na introdução de carregamentos de fotografias, podem-se eliminar linhas, bastando para tal selecionar a linha completa e pressionar a tecla "Delete", no computador.
Acrescentar linhas de Logs
Pode-se adicionar linhas de Logs usando a opção disponibilizada pelo botão "Inserir Log". Para acrescentar uma linha é necessário saber o identificador único (logGuid – LUID) do Log no site geocaching.com, ou (mais simples) o endereço completo do Log.
Este "LUID" ou o endereço do Log é introduzido na caixa "Adicionar Log" e fazendo "Confirmar" o Log é acrescentado à lista, com a denominação "Manual", e pode-se a partir daqui carregar fotos como anteriormente descrito. No caso de se preencherem os campos opcionais "Nome da cache", "Tipo de Log" e "Data de log", esses dados serão os apresentados na nova linha (estes três campos são meramente indicativos e não necessitam de ser exatos).
Registo Automático de TBs
A ferramenta Registo Automático de TBs, Trackables Logger, permite efetuar de um modo automático vários tipos de Logs para vários TBs ou Geocoins em simultâneo.
Sabendo o código trackable de cada TB ou Geocoin, colocam-se os mesmos no campo "Códigos dos TBs", sequencialmente e separados por ponto e vírgula.
Escreve-se um texto que será igual para todos os registos efetuados, na caixa "Texto".
Define-se a data para os Logs no campo "Select Date".
Define-se o tipo de movimento pretendido, entre "Descobrir", "Retirar", "Mover inventário" ou "Mover coleção".
Pressiona-se o botão "Processar tudo" e aguarda-se pela mensagem "Processamento terminado" na caixa "Resultado".
Editor de Bookmarks
Os Premiums Membres sabem da grande vantagem que é o uso das Listas de Bookmarks. As bookmarks podem ser usadas para marcar o top 10 das caches favoritas, ou sugerir caches para os visitantes da nossa área. Podem-se criar listas de favoritos e compartilhá-las com os geocachers amigos. Podem ser usadas simplesmente para planear uma próxima aventura de geocaching. Agora com a ferramenta "Editor de Bookmarks" passou a ser mais simples editar qualquer das nossas bookmarks, adicionando em bloco várias caches a uma determinada lista.
Para adicionar caches a uma determinada bookmark, colocam-se os códigos GC no campo "Códigos das caches", sequencialmente e separados por ponto e vírgula ou um código por linha. Escolhe-se a bookmark no campo inferior onde existe a lista com todas as bookmarks do utilizador e pressiona-se o botão"Processar". A bookmark escolhida é automaticamente atualizada.
Coordenadas e Distâncias
A conversão de coordenadas, apesar de ser uma tarefa matemática simples, pode ser uma pequena dor de cabeça, e qualquer engano pode deixar uma cache para trás (ou para o lado). Não pode haver margens para erro nas nossas latitudes e longitudes, temos que ter sempre uma ferramenta de conversão de coordenadas à mão, e nada melhor que a ter na nossa aplicação preferida.
No campo "Coordenadas Originais" são apresentadas, por defeito, as coordenadas definidas em "home coordinates" no perfil de utilizador no geocaching.com. É neste campo que se deve colocar o conjunto de coordenadas a converter, que pode ser qualquer formato de coordenadas válido. De seguida pressiona-se o botão "Converter" e são mostradas as coordenadas convertidas nos quatro formatos habituais do geocaching.com.
Do lado direito do écran é mostrado o mapa onde estão assinaladas as coordenadas convertidas.
Por outro lado, o separador "Calculadora de Distâncias" possibilita-nos, com exatidão, saber a distância entre coordenadas, em metros, milhas, etc. Ferramenta essencial quando persistem dúvidas quanto à proximidade de outras caches quando estamos a esconder uma nova cache. Ou ainda saber que direção tomar para o ponto final daquela determinada cache Letterbox Hybrid, através do azimute calculado.
Descarregar Spoilers
A aplicação Geopt.org Geocaching Tools disponibiliza download e exportação de imagens das páginas das caches para GPS Garmin, com destaque para as imagens Spoiler, a partir de uma lista de caches em gpx. Esta funcionalidade é apenas para modelos de aparelhos de GPS que suportem visualização de imagens.
(... secção do manual ainda em atualização ...)
Criar PQs (Portugal)
Agora está disponível um gerador de Pocket Queries, para Premium Members, onde se poderá criar Pocket Queries de forma automática e personalizada, com os filtros regularmente mais utilizados, seja por distâncias às coordenadas fornecidas, seleção de distritos e incluindo ou excluindo caches encontradas e escondidas.
Estas Pocket Queries funcionam para todas as caches ativas de Portugal, desde o ano de 2001. Sendo que a vida das caches pode não ser muito estável, podendo muitas ser arquivadas ou mesmo reativadas, a gestão da quantidade de caches por Pocket Querys não é um processo muito simples, tendo em conta a constante necessidade de alteração das suas datas limites para as manter eficientes.
Assim, consoante os filtros aplicados, a ferramenta calcula automaticamente as datas que deverão ser usadas para cada Pocket Query, de modo a que cada uma delas não exceda o limite de geocaches imposto pelo site geocaching.com, atualmente de 1000 (ou 500, no caso de se preferir que a Pocket Query gerada seja enviada ao utilizador por email). No entanto, o limite pode ser ajustado pelo utilizador, de modo a existirem as folgas necessárias para o caso de reativação de caches.
Do lado direito do écran do Gerador estão as opções de filtragem das caches que se pretendem incluir/excluir das Pocket Queries:
- Excluir Founds e Own - Se selecionada a opção, serão excluídas todas as caches Encontradas mas também as escondidas;
- Todos os Distritos - Se selecionada a opção, é desabilitada a possibilidade de escolha de Distritos da lista e serão incluídas as caches de todos os distritos de Portugal;
- Lista de Distritos - Com a opção "Todos os Distritos" desabilitada, apenas serão contabilizadas as caches dos distritos selecionados pelo utilizador (a cada alteração à seleção é necessário carregar no botão "OK" que automaticamente aparece ao lado direito);
- Por coordenadas - Com esta opção selecionada, apenas as caches dentro da área definida pelo conjunto da coordenada central e os "Kms" de raio serão contabilizadas para as Pocket Queries (ver abaixo como se define a área);
- Max Caches - Imposição de limite para a quantidade de caches por Pocket Query, atualmente não mais que 999 (a cada alteração à quantidade é necessário carregar no botão "OK" que automaticamente aparece ao lado direito);
- Utilizador e Password - Apesar da Aplicação Geopt.org Geocaching Tools já contar com Autenticação Automática em geocaching.com, é necessário aqui, no Gerador Automático de Pocket Queries de Portugal, informar novamente o acesso, uma vez que este Gerador não conta ainda com nenhuma API desenvolvida do lado do site geocaching.com.
A definição da área para as caches é efetuada no écran "Mapa de PQ" que é acionado ao se carregar num dos campos: "Por coordenadas" ou "Kms":
As instruções estão claras no écran, sendo que para se mover o mapa usa-se o botão direito do rato, para se selecionar o centro faz-se duplo clique com o botão esquerdo do rato, e para se escolher o raio em kms usa-se a caixa "Distância selecionada". A caixa "Coordenadas selecionadas" mostra sempre as coordenadas que irão ser usadas como centro, sendo que se pode definir automaticamente as coordenadas centrais como as coordenadas de casa (definidas em geocaching.com) usando o botão "Coordenadas por Defeito". Pode-se colocar um nome no campo "Nome a usar na PQ" o qual fará parte do nome das PQs a serem criadas. Caso este campo não seja preenchido serão colocadas as coordenadas do centro no nome das PQs. Após definição da área carrega-se em "Confirmar" para se voltar ao écran do Gerador.
Por fim, para criar as Pocket Queries mostradas na caixa superior esquerda (ou editá-las, no caso de já anteriormente criadas), carrega-se em "Criar/Editar PQs" e aguarda-se o resultado que é informado na caixa inferior esquerda.
As Pocket Queries só chegarão ao utilizador quando forem definidos pelo mesmo os dias da semana em que deverão correr. Isto no site geocaching.com em
Se numa próxima utilização desta funcionalidade, as opções de filtragem se mantiverem (ou seja, mesmos distritos, esconder encontradas, etc), as PQs serão editadas, em vez de serem criadas novas, mantendo-se os dias da semana previamente selecionados para correr.
Assim, sem complicações.
| < Anterior | Seguinte > |
|---|
