位置情報サービス
アプリケーションにユーザの位置情報を送信します。
GET
<a href="location:self?{パラメータ}">
POST
<form action="location:self" method="post">
...
<input type="submit" value="位置情報を取得する" />
</form>
パラメータ一覧:
| 名前 | 必須 | 説明 |
|---|---|---|
| url | 位置情報を取得後に遷移するURL (省略された場合は Gadget XML に記述されたスタートURL) | |
| type | 位置情報の種別 (gps=GPS) |
- Shell App Frameworkは位置情報取得に対応しておりません。
- href属性などでパラメータをURLに含めて送る際にはパラメータの値はURIエスケープする必要があります。
- 位置情報を送信後、urlに遷移する際、自動的に"datum"パラメータに日本測地系(wgs84固定)、"lat"パラメータに緯度、"lon"パラメータに経度が付与されます。
- 位置情報を送信後、urlに遷移する際、result 値が付与されます。 成功であれば ”1” がエラーの場合は ”0” が返ります。
- 位置情報サービスにおいては "type" に "gps" のみ指定できます。 "cell" を指定しても "gps" として扱われます。
サンプル
<a href="location:self?url=http%3A%2F%2Fexample.com">位置情報を取得する</a>
<form action="location:self" method="post">
<input type="hidden" name="url" value="`http://example.com"` />
<input type="submit" value="位置情報を取得する" />
</form>
更新履歴
- 2012/08/28
- resultフィールドに関する事項を追加。