オート GPS リマインド簡易登録機能説明書 （sp モード版

Copyright © 2013 NTT DOCOMO INC. All rights reserved.
オート GPS リマインド簡易登録機能説明書
（sp モード版）
1.0 版
平 成
2 5
年
株 式 会 社
1 1
月
N T T
1 1
日
ド コ モ
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
目次
1. はじめに ...................................................................................................................................................................................................... 1
2. オート GPS リマインド ............................................................................................................................................................................ 1
2.1. 対応機種・対象ユーザについて................................................................................................................................................. 1
3. オート GPS リマインド簡易登録機能 ............................................................................................................................................... 2
3.1. サービス提供方法 ........................................................................................................................................................................... 4
3.2. オート GPS リマインド簡易登録方法........................................................................................................................................ 6
3.2.1. アプリ間連携による登録............................................................................................................................................................ 6
3.2.2. 独自スキームによる登録 .......................................................................................................................................................... 9
4. 注意事項 ................................................................................................................................................................................................ 11
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
変更履歴
版
項目
修正
1.0
-
-
内容
新規作成
－ 商標について－
・「i コンシェル」は NTT ドコモの登録商標です。
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
1. はじめに
本資料は、株式会社 NTT ドコモ（以下ドコモ）が提供するオート GPS リマインド簡易登録機能を利用
した Intent およびリンクの生成方法等について説明することを目的としています。
2. オート GPS リマインド
オート GPS リマインドとは、i コンシェルのオート GPS インフォメーション機能を利用したドコモが提供するサービ
スです。お知らせをして欲しい場所、メモなどを事前に設定しておくと、設定場所周辺への到着時にインフォメー
ションでお知らせします。
ユーザは i コンシェルアプリのオート GPS リマインドメニューから、「お知らせ場所｣｢緯度｣｢経度｣「お知らせ内容」
「開始日」「有効期間」「時間帯」「半径」を設定する事により、有効期間中にオート GPS により通知された位置情
報が設定したエリアと一致した際に、インフォメーションにてお知らせ内容を受け取る事ができます。
・1 ユーザにつき最大 10 件のオート GPS リマインドを設定することができます。
・オート GPS リマインド 1 件につき受け取るインフォメーションは 1 通のみとなります。
・i コンシェルアプリのオート GPS リマインドメニューから設定の変更や削除ができます。
2.1. 対応機種・対象ユーザについて
i コンシェル契約をしており、ｉコンシェルアプリ及びオートＧＰＳアプリが対応している Android 端末をご利用のユ
ーザ。
i コンシェルアプリがプリインされている機種については、端末スペック表を参照してください。
1
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
3. オート GPS リマインド簡易登録機能
Android アプリもしくはコンテンツ提供者サイト上に設置したオート GPS リマインドの設定値をパラメータとする
Intent 発行契機および独自スキームによるリンクをユーザがタップすると、お知らせ場所やお知らせ内容などが
予め設定された状態で、i コンシェルアプリ内のオート GPS リマインドメニューに遷移する事ができます（以降、オ
ート GPS リマインド簡易登録[機能]と呼称）。通常、オート GPS リマインドはユーザが自ら i コンシェルアプリから
設定する必要がありますが、オート GPS リマインド簡易登録機能を利用することにより、コンテンツ提供者の指
定する設定値を簡単な手順でオート GPS リマインドに設定することができます。
詳細設定窓
をタップ
設定ボタンを
タップ
[ i コンシェルアプリ ]
[ i コンシェルアプリ ]
[ コンテンツ提供者サイト ]
or
[ Android アプリ ]
＜オート GPS リマインド簡易登録機能利用イメージ＞
2
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
[待ち受け画面]
[i コンシェルアプリ]
[i コンシェルアプリ]
＜オート GPS リマインドによるインフォメーション受信イメージ＞
3
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
3.1. サービス提供方法
Android アプリまたはコンテンツ提供者サイト上にオート GPS リマインド簡易登録用の Intent の発行契機または
独自スキームによるリンクを作成するだけで、オート GPS 簡易登録機能を利用可能です。
オート GPS リマインド簡易登録機能を利用することにより設定可能な項目は以下の通りです。
「お知らせ場所｣｢緯度｣｢経度｣「測地系」「お知らせ内容」「開始日」「有効期間」「時間帯」「半径」「リンク名」「遷移
先 URL」
以下に、各設定項目に対応する画面部分を図示します。
詳細設定窓
をタップ
設定ボタンを
タップ
お知らせ場所
お知らせ内容
緯度、経度、測地系
時間帯
開始日 半径
お知らせ場所を設定しておくと検索用テキス
トボックスに設定内容が表示されます。
なお、お知らせ場所が設定されるのは緯度、
経度の情報がない場合のみになります。
＜オート GPS リマインド簡易登録時の対応設定項目＞
4
有効期間
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
お知らせ内容
“設定した場所の近くにきました
｢お知らせ内容｣“と表示されます。
お知らせ内容
緯度、経度、測地系
件名に“設定した場所の近くに来
ました”と表示されます。
リンク名、遷移先 URL
＜オート GPS リマインドによるインフォメーション受信時の対応設定項目＞
5
お知らせ内容
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
3.2. オート GPS リマインド簡易登録方法
オート GPS リマインド簡易登録方法にはアプリ間連携を利用する方法と独自スキームによるリンクを利用する方
法の２種類があります。以下に登録方法を示します。
3.2.1. アプリ間連携による登録
アプリ間連携によるオート GPS リマインドの簡易登録方法は以下になります。
方式
明示的Intent
パーミッション
-
メソッド
startActivity
パラメータ
Action
-
className
packageName
com.nttdocomo.android.iconcier_contents
className
com.nttdocomo.android.iconcier_contents.RemindSetAc
tivity”
Data
-
category
-
Extra
キー名
値
※1
※2
型
location
種別
説明
サイズ
String
54byte
O
お知らせ場所
住所や施設名を指定してください。
住所例：
東京都港区東新橋1-6-1、銀座4丁目
(※一部でも可)
施設例：
東京タワー、新宿駅
lat
String
13byte
O
緯度 ※3
lon
String
13byte
O
経度 ※3
datum
int
1byte
O
測地系
以下のパラメータを設定してください。
0：世界測地系(デフォルト)
1：日本測地系
上記以外の値が設定された場合、
0(世界測地系)が設定されます。
content
String
140byte
O
お知らせ内容
startday
String
8byte
O
開始日
形式：YYYYMMDD
6
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
period
int
2byte
O
有効期間
以下のパラメータを設定してください。
11：:当日
12：2日
13：3日
14：4日
15：5日
16：6日
17：1週間
21：1ヶ月
23：3ヶ月
time
String
8byte
O
時間帯
開始時刻、終了時刻を続けて入力して
ください。
形式：hh00hh00(24時間表記)
rad
int
5byte
O
半径
単位：メートル(m)
以下のいずれかの値を設定してくださ
い。
500
1000
2000
5000
10000
offerlink
String
150byte
O
リンク名
offerurl
String
1024byte
M
遷移先URL
リンク名を設定した場合、遷移先URL
もしくはコンテンツ提供者遷移先アプリ
は必須となります。
サンプル
type
-
flag
-
activity起動の際は、通常起動(FLAG_ACTIVITY_NEW_TASKを設定しない)とする
intent = new Intent();
intent.setClassName(“com.nttdocomo.android.iconcier_contents”,
“com.nttdocomo.android.iconcier_contents.RemindSetActivity”);
intent.putExtra(“location”, location);
intent.putExtra(“lat”, lat);
intent.putExtra(“lon”, lon);
intent.putExtra(“datum”, datum);
intent.putExtra(“content”,content);
intent.putExtra(“startday”, startday);
7
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
intent.putExtra(“period”, period);
intent.putExtra(“time “, time);
intent.putExtra(“rad”, rad);
intent.putExtra(“offerlink”, offerlink);
intent.putExtra(“offerurl”, offerurl);
startActivity(intent);
M： 必須
※1 非必須項目が、未設定の場合や不正な形式で設定された場合、画面のデフォルト値が設定されます。
※2 指定された文字長までを、先頭から抜き出して使用します。
※3 緯度経度の指定は以下の形式をサポートします。
①
度分秒緯度経度（秒は小数点3位まで） 例：139.45.32.350
②
十進緯度経度（単位度、小数）
③
ミリ秒緯度経度（単位ミリ秒、整数）
例：139.123456
例：503589217
8
O： オプション
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
3.2.2. 独自スキームによる登録
独自スキームによるオートＧＰＳリマインドの簡易登録方法は以下になります。
方式
URLリンク
nttdocomo://com.nttdocomo.android.iconcier_contents.RemindSetActivity
パラメータ ※1※
2
名称
location
サイズ
54byte
種別
説明
O
お知らせ場所 ※3
住所および施設名を指定してください。
住所例：
東京都港区東新橋1-6-1、銀座4丁目(※一部でも可)
施設例：東京タワー、新宿駅
lat
13byte
O
緯度 ※4
lon
13byte
O
経度 ※4
datum
1byte
O
測地系
以下のパラメータを設定してください。
0：世界測地系(デフォルト)
1：日本測地系
上記以外の値が設定された場合、0(世界測地系)が設定されます。
content
140byte
O
お知らせ内容 ※3
startday
8byte
O
開始日
形式：YYYYMMDD
period
2byte
有効期間
O
以下のパラメータを設定してください。
11：:当日
12：2日
13：3日
14：4日
15：5日
16：6日
17：1週間
21：1ヶ月
23：3ヶ月
time
8byte
時間帯
O
開始時刻、終了時刻を続けて入力してください。
形式：hh00hh00(24時間表記)
rad
5byte
半径
O
単位：メートル(m)
9
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
以下のいずれかの値を設定してください。
500
1000
2000
5000
10000
offerlink
150byte
O
リンク名 ※3
offerurl
1024byte
M
遷移先URL ※3
※条件付
コンテンツ提供者リンク名を設定した場合、コンテンツ提供者遷移
先URLもしくはコンテンツ提供者遷移先アプリは必須となります。
サンプル
<a
href=”nttdocomo://com.nttdocomo.android.iconcier_contents.RemindSetActivity?location=%
82%d0%82%c2%82%b6%83i%83%7c%83%8a&lat=128441359&lon=503169456&datum=1&content=%83e
%83%8c%83r%82%c5%8f%d0%89%ee%82%b3%82%ea%82%bd%83C%83%5e%83%8a%83A%83%93&start
day=20110520&period=15&time=17002000&rad=500&offerlink=%82%d0%82%c2%82%b6%83i%83
%7c%83%8a%20%93%8c%8b%9e%89w%93X&offerurl=http%3a%2f%2fdocomo%2eco%2ejp%2fhitsuji%
2dnapoli”>オートGPSリマインドを登録する</a>
M： 必須
※1 非必須項目が、未設定の場合や不正な形式で設定された場合、画面のデフォルト値が設定されます。
※2 指定された文字長までを、先頭から抜き出して使用します。
※3 Shift_JIS で URL エンコード済の値を設定してださい。
※4 緯度経度の指定は以下の形式をサポートします。
①
度分秒緯度経度（秒は小数点3位まで） 例：139.45.32.350
②
十進緯度経度（単位度、小数）
例：139.123456
③
ミリ秒緯度経度（単位ミリ秒、整数）
例：503589217
10
O： オプション
Copyright © 2013 NTT DOCOMO INC. All rights reserved.
4. 注意事項
オート GPS リマインド簡易登録機能を提供する際の注意事項について説明します。
[1] ユーザは、オート GPS リマインド簡易登録機能を利用して、i コンシェルアプリのオート GPS リマインドメニュ
ーへ遷移した後に、「お知らせ場所｣｢緯度｣｢経度｣「お知らせ内容」「開始日」「有効期間」「時間帯」「半径」を
変更する事ができるため、オート GPS リマインド簡易登録用 Intent もしくはリンクに設定した項目がそのまま
設定されるとは限りません。
11