Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/PokemonGoers/PokeData

In this project you will scrape as much data as you can get about the *actual* sightings of Pokemons. As it turns out, players all around the world started reporting sightings of Pokemons and are logging them into a central repository (i.e. a database). We want to get this data so we can train our machine learning models. You will of course need to come up with other data sources not only for sightings but also for other relevant details that can be used later on as features for our machine learning algorithm (see Project B). Additional features could be air temperature during the given timestamp of sighting, location close to water, buildings or parks. Consult with Pokemon Go expert if you have such around you and come up with as many features as possible that describe a place, time and name of a sighted Pokemon. Another feature that you will implement is a twitter listener: You will use the twitter streaming API (https://dev.twitter.com/streaming/public) to listen on a specific topic (for example, the #foundPokemon hashtag). When a new tweet with that hashtag is written, an event will be fired in your application checking the details of the tweet, e.g. location, user, time stamp. Additionally, you will try to parse formatted text from the tweets to construct a new “seen” record that consequently will be added to the database. Some of the attributes of the record will be the Pokemon's name, location and the time stamp. Additional data sources (here is one: https://pkmngowiki.com/wiki/Pok%C3%A9mon) will also need to be integrated to give us more information about Pokemons e.g. what they are, what’s their relationship, what they can transform into, which attacks they can perform etc.
https://github.com/PokemonGoers/PokeData

Last synced: 28 days ago
JSON representation

Host: GitHub
URL: https://github.com/PokemonGoers/PokeData
Owner: PokemonGoers
License: apache-2.0
Created: 2016-08-12T06:07:22.000Z (over 8 years ago)
Default Branch: develop
Last Pushed: 2017-01-03T12:58:08.000Z (almost 8 years ago)
Last Synced: 2024-10-31T17:26:40.296Z (about 1 month ago)
Language: JavaScript
Size: 5.52 MB
Stars: 9
Watchers: 13
Forks: 6
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-golang-repositories - PokeData

README

        # PokeData

[![Build Status](https://travis-ci.org/PokemonGoers/PokeData.svg?branch=develop)](https://travis-ci.org/PokemonGoers/PokeData)[![Join the chat at https://gitter.im/pokemongoers/PokeData](https://badges.gitter.im/pokemongoers/PokeData.svg)](https://gitter.im/pokemongoers/PokeData?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

## API Documentation

 A detailed documentation of the API is available [here](http://pokedata.c4e3f8c7.svc.dockerapp.io:65014/doc/).

 

## API Demo

 A demo of our API can also be found [here](http://pokedata.c4e3f8c7.svc.dockerapp.io:65014/doc/).

 

## Data Sources

 Data accessible through the API has been extracted from these sources:

  - [Twitter](https://twitter.com/)

  - [PokeSniper](https://pokesnipers.com)

  - [PokeRadar](https://www.pokeradar.io)

  - [Skiplagged](https://skiplagged.com/catch-that)

  - [PokeCrew](https://www.pokecrew.com)

  - [PokeZZ](http://pokezz.com/)

  - [PokeDexs](https://pokedexs.com/)

  - [FastPokeMap](https://fastpokemap.se/)

  - [PokeMap](https://www.pokemap.net/)

## Build pokemon database and listen for pokemon sightings

## To run locally without docker

- Clone this repo

- To run locally, mongodb is required, use 'mongod' to do so (standard port 27017, no credentials)

- change the script part of package.json to the following

- then start listeners to fill the DB, build the pokemon collection (see below) and run "npm start" to expose the API on `localhost:8080`

```

"scripts": {

    "start" : "node app.js",

    "listen": "node scripts/listen.js",

    "build" : "node scripts/build.js",

    "test"  : "node test/main.js"

  }

```

## Build pokemon database

```

npm run build --collection=pokemon

```

## Listen for PokemonSightings

- Listen for pokemon sightings

```

// data-source-name - rarePokemon, pokeRadar, skiplagged, pokecrew, fastpokemap, pokezz, pokedexs, pokemap

npm run listen -collection=

```

- Listen for Twitter pokemon sightings:

```

CONSUMER_KEY= CONSUMER_SECRET= ACCESS_TOKEN= ACCESS_TOKEN_SECRET= NODE_ENV= npm run listen -collection=twitter

```

- CONSUMER_KEY, CONSUMER_SECRET, ACCESS_TOKEN, ACCESS_TOKEN_SECRET - keys provided by twitter (https://apps.twitter.com/)

## To run in production

- To use mlab as a database, get the username, password, uri and the collection name.

## Build pokemon database

```

MLAB_USERNAME= MLAB_PASSWORD= MLAB_URI= MLAB_COLLECTION= npm run build -collection=pokemon

```

## Listen for PokemonSightings

- Listen for pokemon sightings

```

// data-source-name - rarePokemon, pokeRadar, skiplagged, pokecrew, fastpokemap, pokezz, pokedexs, pokemap

MLAB_USERNAME= MLAB_PASSWORD= MLAB_URI= MLAB_COLLECTION= npm run listen -collection=

```

- Listen for Twitter pokemon sightings:

```

MLAB_USERNAME= MLAB_PASSWORD= MLAB_URI= MLAB_COLLECTION= CONSUMER_KEY= CONSUMER_SECRET= ACCESS_TOKEN= ACCESS_TOKEN_SECRET= NODE_ENV= npm run listen -collection=twitter

```

- CONSUMER_KEY, CONSUMER_SECRET, ACCESS_TOKEN, ACCESS_TOKEN_SECRET - keys provided by twitter (https://apps.twitter.com/)

## Docker Build

 To build the project using Docker, follow these steps.

 

 1. Execute the following commands in the terminal.

  

  ```bash

  #!/bin/bash

  

  # Stop all containers

  docker stop $(docker ps -a -q)

  

  # Delete all containers

  docker rm $(docker ps -a -q)

  

  # Delete all images

  docker rmi $(docker images -q)

  

  # Run the latest build from the develop branch

  docker run --env-file  -p 49160:8080 --name  

             -d pokemongoers/pokedata:develop npm start

  

  # Check the status of the container

  docker ps

  

  ```

 2. The application can be accessed at the URL `HOST_IP:49160`.

##Config

There is a configuration file `config.js` in the root folder.

If you don't want to pass parameters for DB connection and twitter credentials everytime you can adapt it.

Just replace the `process.env.*` with the desired value. The `"database"` key is  development mode, `"shared_database"` for production mode and `"twitter"` holds the twitter information.

##Contributors

- swathi-ssunder

- samitsv

- vivek-sethia

- jonas-he

- fabe85