geogami

🗺 A map based spatial learning game running on web technologies

https://github.com/origami-team/geogami

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ✓
    DOI references
    Found 3 DOI reference(s) in README
  • ✓
    Academic publication links
    Links to: zenodo.org
  • â—‹
    Academic email domains
  • â—‹
    Institutional organization owner
  • â—‹
    JOSS paper metadata
  • â—‹
    Scientific vocabulary similarity
    Low similarity (12.3%) to scientific vocabulary

Keywords

gamification-learning orientation spatial-learning
Last synced: 6 months ago · JSON representation ·

Repository

🗺 A map based spatial learning game running on web technologies

Basic Info
  • Host: GitHub
  • Owner: origami-team
  • License: mit
  • Language: TypeScript
  • Default Branch: master
  • Homepage: https://geogami.ifgi.de/
  • Size: 188 MB
Statistics
  • Stars: 5
  • Watchers: 6
  • Forks: 3
  • Open Issues: 117
  • Releases: 32
Topics
gamification-learning orientation spatial-learning
Created over 6 years ago · Last pushed 6 months ago
Metadata Files
Readme License Citation

README.md

GeoGami

DOI

GeoGami is a location-based game that allows the user to play and create map-based games - for any place in the world. GeoGami is intended for users to improve and develop their spatial intelligence by improving their orientation skills and cognition. It is created by the Spatial Intelligence Lab (SIL) of the Institute for Geoinformatics, University of Münster.

For more information on GeoGami and our research visit the Website. It's available in both English and German.

Table of Contents

Installation Guide

GeoGami runs on both iOS and Android devices with a compass sensor and a GPS or GSM module. The app is still under development and it would be helpful if you all contribute by reporting bugs and functional limitations here: issues.

You can install GeoGami...

  1. on your iOS device: Visit App Store.
  2. on your Android device: Visit Google Play Store.

After installation, you can play the game but if you want to create a game and be part of newer version updates by registering as a user. To do that, simply register using your email id and set up a strong password. With that you are ready to play.

How to play a GeoGame

Requirement: In order to play a game in GeoGami, you need to install GeoGami to your device. You should check whether your internet connection is strong.

GeoGami offers many games in both Real World and Virtual World. In this video, we will see how to play a GeoGame with Real World games.Depending on your location availability you can choose the game of your choice. To play GeoGami you need a GPS-enabled smartphone or tablet with internet access and an integrated compass. For best accuracy, use a device that has a SIM card.

If you don't like the game list, you can create a game of your own by registering as a user.

Watch the video

How to Create a GeoGame

The GeoGami games that you can find in our games database so far have been created by the GeoGami users themselves. You can create your own game for your location. Choose from different task types, add photos and audio recordings and adapt the map to your needs.

To do that you need to install GeoGami and register as a User in GeoGami. This can be done by entering your email id in the login section. After registration, login with your user credentials that you have created when registering.

In this video, we will see how to create a game in geogami with a single task. You can create your games with as many task types as you want.

https://uni-muenster.sciebo.de/s/g6eXo4xB7264g08

Map Features and Task Types in GeoGami

Table of Content

Task Types

Task types are like game types meant to access the navigation skills and abilities.

These are classified as :

Navigation Tasks

| Navigation to Flag | Navigation with Arrow | Navigation via Text | Navigation via Photo | | ------------------ | --------------------- | ------------------- | -------------------- | | | | | |

Thematic Tasks

| Self location Task | Object location Task | Direction determination Task | Free Tasks | | ------------------ | -------------------- | ---------------------------- | ---------- | | | | | |

Additionally we have Information type where you can explain the game in detail to the players, give instructions and rules before proceeding to play.

Map Features

Map Features have two settings: Map settings and Marker settings.

Map Settings

Map Settings is where you control how to project the background map.

| Map Features | Types | | ------------- |:-------------:| | Zoom | manual |Zoom to the task|Zoom to the game| off | |Map Section | movable | automatically-centered | static | | | Map Rotation| manual | automatically | automatically on-demand | fixed to north | | Map Type | standard map| satellite image | 3D view | Blank map |

With Map Type we have options to use the above map types with on-demand and swipe capabilities.

Marker Settings

| Marker Settings | Description | | ----------------| :----------------------------------:| | Location Marker | You can know where you are right now | | View Direction Marker | You can know the direction currently faced by your device | | Track Recording | Route tracing | | Buffer | shows a section of the map at the location from 20m to 100m | | Highlighting Landmarks | Highlight the landmarks which was provided in the region surrounding the destination | | Highlighting Street Section | Highlight the street section at the destination, this feature is helpful in deciding which route to take on |

With Location Marker and View Direction Marker you can use on/on-demand/at the beginning of the task/off capabitilies. Track Recording can be done for the entire game/ only for the current task/ also for the next task.

Contact

Spatial Intelligence Lab (SIL) Institute for Geoinformatics University of Münster Heisenbergstraße 2 48149 Münster Mail: geogami(at)uni-muenster.de

Team :technologist:: https://geogami.ifgi.de/kontakt.html#team

License

MIT Copyright(C) 2021 - GeoGami.

Implemented by re:edu.

Owner

  • Name: GeoGami
  • Login: origami-team
  • Kind: organization

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: GeoGami
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Yousef
    family-names: Qamaz
  - given-names: Angela
    family-names: Schwering
  - given-names: Mitko
    family-names: Aleksanrov 
  - given-names: Felix
    family-names: Erdmann
  - given-names: Janina
    family-names: Bistron
  - given-names: GeoGami Community
identifiers:
  - type: doi
    value: 10.5281/zenodo.10018830
repository-code: 'https://github.com/origami-team/geogami'
url: 'https://geogami.ifgi.de/'
license: MIT
version: 3.2.2
date-released: '2024-01-26'

GitHub Events

Total
  • Create event: 48
  • Release event: 3
  • Issues event: 110
  • Watch event: 1
  • Delete event: 53
  • Issue comment event: 9
  • Push event: 134
  • Pull request event: 108
Last Year
  • Create event: 48
  • Release event: 3
  • Issues event: 110
  • Watch event: 1
  • Delete event: 53
  • Issue comment event: 9
  • Push event: 134
  • Pull request event: 108

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 117
  • Total pull requests: 172
  • Average time to close issues: 21 days
  • Average time to close pull requests: 2 months
  • Total issue authors: 3
  • Total pull request authors: 3
  • Average comments per issue: 0.12
  • Average comments per pull request: 0.26
  • Merged pull requests: 124
  • Bot issues: 0
  • Bot pull requests: 25
Past Year
  • Issues: 62
  • Pull requests: 69
  • Average time to close issues: 4 days
  • Average time to close pull requests: about 18 hours
  • Issue authors: 3
  • Pull request authors: 2
  • Average comments per issue: 0.06
  • Average comments per pull request: 0.03
  • Merged pull requests: 55
  • Bot issues: 0
  • Bot pull requests: 2
Top Authors
Issue Authors
  • YouQam (102)
  • eidueidu (13)
  • helenmms (2)
Pull Request Authors
  • YouQam (146)
  • dependabot[bot] (25)
  • JaninaBistron (1)
Top Labels
Issue Labels
bug (2) enhancement (1)
Pull Request Labels
dependencies (25)

Dependencies

ios/App/Podfile cocoapods
  • Capacitor >= 0
  • CapacitorCordova >= 0
  • CapacitorKeepScreenOn >= 0
  • CapacitorVoiceRecorder >= 0
  • CordovaPlugins >= 0
android/app/build.gradle maven
  • androidx.appcompat:appcompat $androidxAppCompatVersion implementation
  • com.android.support:design 23.2.1 implementation
  • com.google.android.material:material 1.0.0 implementation
  • junit:junit $junitVersion testImplementation
electron/package.json npm
  • electron ^7.2.4 development
  • @capacitor/electron ^1.5.2
  • electron-is-dev ^1.1.0
electron/yarn.lock npm
  • @capacitor/core 1.5.2
  • @capacitor/electron 1.5.2
  • @electron/get 1.12.2
  • @sindresorhus/is 0.14.0
  • @szmarczak/http-timer 1.1.2
  • @types/node 12.12.48
  • boolean 3.0.1
  • buffer-crc32 0.2.13
  • buffer-from 1.1.1
  • cacheable-request 6.1.0
  • clone-response 1.0.2
  • concat-stream 1.6.2
  • config-chain 1.1.12
  • core-js 3.6.5
  • core-util-is 1.0.2
  • debug 2.6.9
  • debug 4.1.1
  • decompress-response 3.3.0
  • defer-to-connect 1.1.3
  • define-properties 1.1.3
  • detect-node 2.0.4
  • duplexer3 0.1.4
  • electron 7.2.4
  • electron-is-dev 1.1.0
  • encodeurl 1.0.2
  • end-of-stream 1.4.4
  • env-paths 2.2.0
  • es6-error 4.1.1
  • escape-string-regexp 4.0.0
  • extract-zip 1.7.0
  • fd-slicer 1.1.0
  • fs-extra 8.1.0
  • get-stream 4.1.0
  • get-stream 5.1.0
  • global-agent 2.1.12
  • global-tunnel-ng 2.7.1
  • globalthis 1.0.1
  • got 9.6.0
  • graceful-fs 4.2.3
  • graceful-fs 4.2.4
  • http-cache-semantics 4.1.0
  • inherits 2.0.4
  • ini 1.3.5
  • isarray 1.0.0
  • json-buffer 3.0.0
  • json-stringify-safe 5.0.1
  • jsonfile 4.0.0
  • keyv 3.1.0
  • lodash 4.17.20
  • lowercase-keys 1.0.1
  • lowercase-keys 2.0.0
  • matcher 3.0.0
  • mimic-response 1.0.1
  • minimist 1.2.5
  • mkdirp 0.5.4
  • ms 2.0.0
  • ms 2.1.2
  • normalize-url 4.5.0
  • npm-conf 1.1.3
  • object-keys 1.1.1
  • once 1.4.0
  • p-cancelable 1.1.0
  • pend 1.2.0
  • pify 3.0.0
  • prepend-http 2.0.0
  • process-nextick-args 2.0.1
  • progress 2.0.3
  • proto-list 1.2.4
  • pump 3.0.0
  • readable-stream 2.3.7
  • responselike 1.0.2
  • roarr 2.15.3
  • safe-buffer 5.1.2
  • sanitize-filename 1.6.3
  • semver 7.3.2
  • semver-compare 1.0.0
  • serialize-error 7.0.1
  • sprintf-js 1.1.2
  • string_decoder 1.1.1
  • sumchecker 3.0.1
  • to-readable-stream 1.0.0
  • truncate-utf8-bytes 1.0.2
  • tslib 1.11.1
  • tunnel 0.0.6
  • type-fest 0.13.1
  • typedarray 0.0.6
  • universalify 0.1.2
  • url-parse-lax 3.0.0
  • utf8-byte-length 1.0.4
  • util-deprecate 1.0.2
  • wrappy 1.0.2
  • yauzl 2.10.0
package.json npm
  • @angular-devkit/architect ^0.901.1 development
  • @angular-devkit/build-angular ~0.901.1 development
  • @angular-devkit/core ^9.1.1 development
  • @angular-devkit/schematics ~9.1.1 development
  • @angular/cli ^9.1.13 development
  • @angular/compiler ~9.1.2 development
  • @angular/compiler-cli ~9.1.2 development
  • @angular/language-service ~9.1.2 development
  • @capacitor/cli ~2.0.1 development
  • @ionic/angular-toolkit ^2.2.0 development
  • @ionic/lab 3.2.10 development
  • @types/jasmine ~3.5.10 development
  • @types/jasminewd2 ~2.0.3 development
  • @types/node ^12.11.1 development
  • codelyzer ^5.1.2 development
  • ionic ^5.4.5 development
  • jasmine-core ~3.5.0 development
  • jasmine-spec-reporter ~5.0.1 development
  • karma ~5.0.2 development
  • karma-chrome-launcher ~3.1.0 development
  • karma-coverage-istanbul-reporter ~2.1.1 development
  • karma-jasmine ~3.1.1 development
  • karma-jasmine-html-reporter ^1.5.3 development
  • protractor ~5.4.4 development
  • ts-node ~8.8.2 development
  • tslint ~6.1.1 development
  • typescript ~3.8.3 development
  • @angular/common ^9.1.2
  • @angular/core ^9.1.13
  • @angular/forms ^9.1.2
  • @angular/http ^7.2.2
  • @angular/platform-browser ^9.1.2
  • @angular/platform-browser-dynamic ^9.1.2
  • @angular/router ^9.1.2
  • @angular/service-worker ^9.1.2
  • @capacitor/android ^2.4.2
  • @capacitor/core ^2.4.2
  • @capacitor/ios ^2.4.2
  • @ionic-native/core ^5.24.0
  • @ionic-native/device-orientation ^5.26.0
  • @ionic/angular ^5.0.7
  • @ionic/pwa-elements ^3.0.1
  • @ionic/storage ^2.2.0
  • @mapbox/mapbox-gl-draw trygveaa/mapbox-gl-draw#dont-drag-with-multiple-fingers
  • @ngx-translate/core ^12.1.0
  • @ngx-translate/http-loader ^5.0.0
  • @turf/bbox ^6.0.1
  • @turf/boolean-point-in-polygon ^6.0.1
  • @turf/boolean-within ^6.0.1
  • @turf/buffer ^5.1.5
  • @turf/centroid ^6.0.2
  • @turf/circle ^6.0.1
  • @turf/helpers ^6.1.4
  • @turf/mask ^5.1.5
  • @types/dom-mediacapture-record ^1.0.7
  • angular-pipes ^10.0.0
  • capacitor-keep-screen-on ^0.0.4
  • capacitor-voice-recorder ^0.1.4
  • cordova-android ^8.1.0
  • cordova-browser 6.0.0
  • cordova-ios ^5.1.0
  • cordova-plugin-device-orientation ^2.0.1
  • core-js ^3.6.5
  • es6-promise-plugin ^4.2.2
  • jetifier ^1.6.5
  • keycloak-js ^11.0.3
  • lodash ^4.17.19
  • lottie-web ^5.6.8
  • mapbox-gl ^1.13.0
  • mapbox-gl-compare ^0.4.0
  • mapbox-gl-style-switcher ^1.0.3
  • ngx-json-viewer ^2.4.0
  • ngx-lottie ^5.4.0
  • ngx-markdown ^10.1.1
  • ngx-socket-io ^3.3.1
  • osmtogeojson ^3.0.0-beta.3
  • pwa ^1.9.7
  • rxjs ~6.5.5
  • rxjs-compat ^6.6.7
  • source-map ^0.8.0-beta.0
  • tslib ^1.10.0
  • zone.js ~0.10.2
.github/workflows/main.yml actions
  • actions/checkout v2 composite
  • actions/create-release v1 composite
  • actions/setup-java v1 composite
  • actions/upload-release-asset v1 composite
android/build.gradle maven