Skip to content

Sabara/ingressmap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ingress Damage Reports Map

What is this?

A web application to show portals on Google Maps by analyzing Ingress Damage Report mails.

This page can show portals that you have owned once (~= UPC), damage frequency by agents, hours and days.

http://ingress.xii.jp/

Note: This site require Gmail authorization (OAuth 2.0), but this site won't store any of your email authorization/contents. All of the data are directly accessed between your web browser and Gmail servers. See source code for more detail :)

何ができるの?

Google から送られてくる Ingress Damage Report メールを解析して地図上に表示する Web アプリケーションです。

例えば、自分が過去にオーナーだったことのあるポータル(ほぼ UPC に相当)を地図上に表示できます。また、個別のポータルを誰がよく攻撃しているかや、何曜日・何時頃攻撃を受けやすいかもわかります。以下にサイトがあります。

http://ingress.xii.jp/

なお、こちらのサーバには認証情報やメールの内容は一切送らずに、ユーザの Web ブラウザと Google のサーバ間でのみ情報をやりとりしますので安心して使えます(そのかわり大量のデータは処理しずらいですが)。

How to use

Before opening this site, you have to enable to receive Ingress Damage Report mail. Confirm Ingress scanner settings "OPT" - "DEVICE" - "Email" - "Game notifications(Portal under attack, etc)" is checked. Then open http://ingress.xii.jp/ on web browser.

Firstly, a dialog about using current position will pop-up. Press OK if you want to move to current position, or just cancel.

Secondly, click a left top box "Please click here to authorize Gmail API (OAuth 2.0)" to authorize Gmail API. Google's authorization page will pop-up, then login by your Google account and accept permission to use Gmail API on this page.

If authorization succeed, Ingress Damage Report email will load on this page. This process may take a few minutes for the first time. For the second+ time, process should speed up by using local cache.

When email loading finished, it will show portals by colored icons.

Blue: portals got damaged.
Red: portals got damaged AND you have owned once (~= UPC).
Circle: portals got damaged over 24 hours ago.
Arrow: portals got damaged within 24 hours.

If you click a portal icon, a infowindow will pop-up including damage frequency by agents, hours and days. U is unique users per hour, # is the number of damages. Agent names are anonymized for safety.

Double circle icon on top right is current position button.

For iOS users, you can see this page with full-screen mode by "Add to home screen" on Safari.

If you want to cancel Gmail API authorization, access this page and revoke "Ingress Damage Reports Map".

https://security.google.com/settings/security/permissions

使い方

Ingress のスキャナの設定で OPT - DEVICE - Email - Game notifications(Portal under attack, etc). のチェックボックスを有効にしてダメージレポートメールを受け取るようにしておいてください。なお、この Web アプリケーションは Gmail にしか対応していないので Ingress のアカウントのメールアドレスを Gmail 以外にしている場合は Gmail にメールを転送する等の設定をしておいてください。

サイトを開くと、まず現在地を取得するかどうかを問うダイアログがでますので必要に応じて許可をしてください。許可しなくても利用可能です。

次に Gmail API を使って Gmail 内のメールの内容を読み取るための OAuth 2.0 認証を行います(初回の起動時のみ)。画面左上にある "Please click here to authorize Gmail API (OAuth 2.0)" というボックスをクリックすると Google の認証ページがポップ・アップします。Ingress を利用している Google アカウントでログインをして、さらに Gmail API をこの Web アプリケーションで利用するために承認してください。

認証に成功すると Gmail のデータを取得しはじめますのでしばらく待ってください。初回起動時は大量のメールを通信しますので結構時間がかかります。2回目以降はキャッシュを使うのでそこそこ速くなります。

メールの取得が終わるとメールの内容を解析してその結果を地図上に丸いアイコンで表示します。青はダメージを受けたポータル、赤はダメージを受けたポータルのうち自分がオーナーだったことのあるポータル(ほぼ UPC に相当)です。矢印のアイコンは直近24時間以内に攻撃を受けたポータルです。

ポータルのアイコンをクリックすると詳しい内容を表示します。左からポータルの画像、攻撃者一覧、時間帯一覧、曜日一覧です。表中のUは1時間毎のユニークユーザ数、#はダメージ回数です。例えばわんこレゾをやったりするとUは少ないけど#が多いという状況になります。直近24時間以内の攻撃は黄色でハイライトされています。ポータルの画像をクリックすると intel map にとびます。なお、攻撃者のユーザ名は安全のため先頭1文字目以降は伏せ字にしてあります。

右上の二重丸を押すと現在地に移動します(起動時にも現在地に移動します)。

iOS の場合は Safari のメニューから「ホーム画面に追加」をしてホーム画面から起動すると全画面表示が出来ます。初回起動時に認証で画面が進まなくなりますがアプリを再起動すると通常通り使えます。

もし Gmail API の承認を取り消したい場合は以下のページから Ingress Damage Reports Map のアクセス権を取り消してください。

https://security.google.com/settings/security/permissions

Warning

Follow Terms of Service, Agent Protocol, Community Guidelines and respect other agent's privacy. Don't post information about other agent's identity on public. And take care of your information too :)

Ingress Terms of Service

https://www.ingress.com/terms

Agent Protocol

https://support.google.com/ingress/answer/4625064

Ingress Community Guidelines

https://support.google.com/ingress/answer/2808360

注意

Terms of Service、エージェントプロトコル、コミュニティガイドラインを守り、プレーヤーのプライバシーを尊重して利用してください。他のユーザーを特定する情報を公開しないようにしてください。また、自分の情報も間違って公開しないよう注意してください(表示されているポータルはあなたが訪れたことのあるポータルです)。

Ingress Terms of Service

https://www.ingress.com/terms

エージェントプロトコル

https://support.google.com/ingress/answer/4625064?hl=ja

Ingress コミュニティ ガイドライン

https://support.google.com/ingress/answer/2808360?hl=ja

Tips

Here are some useful JavaScript console functions.

Print portals by CSV format. pattern is regexp (optional)

printPortals([pattern])

Print reports by CSV format. pattern is regexp (optional)

printReports([pattern])

Print local cache.

printLocalStorage()

Clear all local cache. Clear cache and reload page may fix problem :P

localStorage.clear()

Disable anonymized agent name. Respect other agent's privacy and don't post information about other agent's identity on public.

function anonymize(str) { return str; }; clearAllPortals(); showAllPortals(); showStatus();

小技

JavaScript コンソールから使えるコマンドをいくつか用意してあります。JavaScript コンソールは Chrome であればメニューの "表示ー開発/管理ーJavaScriptコンソール" で表示出来ます。

ポータル一覧をCSVで表示 pattern で正規表現により絞込可。省略すると全てのポータルを表示。

printPortals([pattern])

レポート一覧をCSVで表示 pattern で正規表現により絞込可。省略すると全てのレポートを表示。

printReports([pattern])

ローカルのキャッシュ全てを表示。

printLocalStorage()

ローカルのキャッシュをクリア。動作がおかしくなったらキャッシュをクリアしてからブラウザをリロードしてみてください。

localStorage.clear()

伏せ字にしてあるエージェント名を表示。エージェントのプライバシーを公開しないよう気をつけて利用してください。

function anonymize(str) { return str; }; clearAllPortals(); showAllPortals(); showStatus();

ダメージレポートメールを受信トレイにいれない(自動でアーカイブする)ための Gmail フィルタ設定方法は以下のページを参照してください。このフィルタを入れるとダメージレポートメールが届いても通知が来なくなります。

https://plus.google.com/+SabaraSabara/posts/iuRTVdpPfBr

Source code

Latest source code is here. License is GPL, feel free to fork and modify it!

https://github.com/Sabara/ingressmap

For Developers

TODO :)

開発者向け情報

自分のサイトで Ingress Damage Reports Map を運用するには以下のようにします。

Google Developers Console から Gmail API と Google Maps JavaScript API v3 を有効にします。

https://console.developers.google.com/

Gmail API は Web Application として Client ID を発行し、Google Maps は Browser Applications として API Key を発行して、それぞれソース中の該当箇所を書き換えておきます。

HTML と JavaScript と CSS を自分のサイト上にコピーして HTML にアクセスすれば起動します。

詳しくは、参考URLを見てください。

Ingress Damage Report Mail Format

TODO :)

Ingress Damage Report Mail のフォーマット

2014年10月20日時点でのフォーマットです。

ingressmap.js の関数 parseBody(body) を見ながら読んでください。また、parserDebug = true にして実行するとパーサのログが表示されるのでそちらも参考にしてください。

まず、全体はヘッダ・ボディ・フッタの三部構成になっています。ヘッダとフッタは定形文でデータは二番目の tr に入っています。

ヘッダ(Ingress - Begin Transmissionの画像)

div > table[width="750px"] > tbody > tr:eq(0)

ボディ

div > table[width="750px"] > tbody > tr:eq(1)

フッタ(Ingress - End Transmissionの画像)

div > table[width="750px"] > tbody > tr:eq(2)

ボディの中身はテーブルになっていて各 tr に色々なデータが入っています。

div > table[width="750px"] > tbody > tr:eq(1) > td > table[width="700px"] > tbody > tr

tr の一行目は必ずエージェントの情報です。

エージェント(agent)

td > span:contains("Agent Name:") + span
td > span:contains("Faction:") + span
td > span:contains("Level:") + span

tr の二行目以降は以下のいずれかの情報が入っています。

横棒(hr) 最初に出現するhrには DAMAGE REPORT の文字が入っています

td[style*="border-bottom: 2px solid #403F41;"]

ポータル名と住所とintel map(portal)

td > div:eq(1) > a[href^="https://www.ingress.com/intel?ll="]

ポータル画像(image) 大きめです(160px)

td > div[style="width:1000px;"] > div[style*="height: 160px"] > img

リンク先のポータル画像(linkedImage) メインのポータル画像よりちょっと小さめです(100px)

td > div[style="width:1000px;"] > div[style*="height: 100px"] > img

リンク破壊の文字列(linkDestroyed) 単数だと LINK DESTROYED, 複数だと LINKS DESTROYED です

td > table[width="700px"] > tbody > tr > td[width="50px"] + td:contains(" DESTROYED")

リンク先のポータル名と住所とintel map(linkedPortal)

td > table[width="700px"] > tbody > tr > td[width="50px"] + td > a[href^="https://www.ingress.com/intel?ll="]

ダメージ情報(damage)

td > table[width="700px"] > tbody > tr > td[width="400px"] > div:contains("DAMAGE:")

最も典型的な、一通のメールで一つのポータルへ攻撃は以下のようなフォーマットです。

agent
hr
portal
image
damage

リンク破壊が伴っていると以下のようになります。例は三本破壊の場合。

agent
hr
portal
image
linkDestroyed
linkedPortal
linkedImage
linkedPortal
linkedImage
linkedPortal
linkedImage
damage

一通のメール中に複数のポータルへの攻撃があると以下のようになります。

agent
hr
portal
image
damage
hr
portal
image
damage
hr
portal
image
damage

正規表現っぽくまとめると以下の様になります。

agent (hr portal image (linkDestroyed (linkedPortal linkedImage)+)* damage)+

もし間違いや新しいフォーマットをみつけたら教えて下さい :)

Related URLs

Google APIs Client Library for JavaScript (Beta)

https://developers.google.com/api-client-library/javascript/start/start-js

Gmail API

https://developers.google.com/gmail/api/

Google Maps JavaScript API v3

https://developers.google.com/maps/documentation/javascript/

Google Developers Console

https://console.developers.google.com/

Author

Sabara

https://google.com/+SabaraSabara

https://github.com/Sabara

以上

About

Ingress Damage Reports Map

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published