Ingress Data Explorer

Read this in other languages: English, 简体中文.

Ingress Data Explorer is a simple toolkit allows you to view Ingress gaming data exported by Niantic labs as part of their GDPR compliance.

It provides a user friendly web UI for you to upload the encrypted zip file you get from Niantic labs, then explore all kinds of data inside.

Everything will be kept exactly on your machine, nothing will be collected and send to backend servers.

Features

• View badge acquisition time and level up time with location (even on map)
• View comm conversations (both way)
• View UPC / UPV on map (require Google API key)
• Generate UPC / UPV JSON for IITC Draw Tools

How to get the data

Send an E-Mail to privacy@nianticlabs.com:

Dear Sir or Madam,
I'd like to request a dump of the raw data Niantic stores about my Ingress account @<account_name>, as regulated under GDPR.
Yours sincerely,
<your_name>

Please remember to change <account_name> to your codename in the game. This will take about 30 days for Niantic to process your request. After done, you will receive two mails, one contains a link for you to download an encrypted zip file, the other is the password to decrypt the zip file.

Run with Docker

1. Install Docker

   • Mac users: https://docs.docker.com/docker-for-mac/install/
   • Windows users: https://docs.docker.com/docker-for-windows/install/

2. Run application

   • Mac or Linux users, please open Terminal, then run:

     docker pull ingresspub/ingress-data-explorer
     docker run -d --restart=always -p 8080:8080 -v $HOME/.h2:/root/.h2:rw --name=ingress-data-explorer ingresspub/ingress-data-explorer

   • Windows users, please open Command Prompt, then run:

     docker pull ingresspub/ingress-data-explorer
     docker run -d --restart=always -p 8080:8080 -v %HOMEDRIVE%%HOMEPATH%/.h2:/root/.h2:rw --name=ingress-data-explorer ingresspub/ingress-data-explorer

3. Open http://127.0.0.1:8080 in your favorite web browser.

4. If you want to stop / remove the running container (data will be kept), run:

   docker rm -vf ingress-data-explorer

5. If you want to use newer version, please perform step 4 first, then do step 2 and 3.

Run as native Java program

Prerequisites

1. Download and install JDK 8
2. Download and install git
   • Windows: https://git-scm.com/download/win
   • Mac: https://git-scm.com/download/mac
   • Linux: https://git-scm.com/download/linux

Build and run

1. Run in Terminal or Command Prompt on Windows:

   git clone git@github.com:ingresspub/ingress.data.gdpr.git
   cd ingress.data.gdpr
   ./mvnw clean install && ./mvnw spring-boot:run -pl web

2. Still in Terminal or Command Prompt on Windows:
   • Windows users:

     mvnw.cmd clean install && mvnw.cmd spring-boot:run -pl web

   • Mac or Linux users:

     ./mvnw clean install && ./mvnw spring-boot:run -pl web
     

3. After your saw Started Application in N seconds, open http://127.0.0.1:8080 in your favorite web browser.

Where are the data stored on my local?

It's in a H2 database under ~/.h2/ingress_gdpr

License

    Ingress Data Explorer is a simple toolkit allows you to view Ingress
    gaming data exported by Niantic labs as part of their GDPR compliance.

    Copyright (C) 2014-2021  SgrAlpha

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.