Google Glass 開発者ガイド位置情報

Google Glass Locationを翻訳しました
＜Google Glass 開発者ガイド Subscriptions ｜Google Glass 開発者ガイド Contacts ＞
目次
原文

Google Glass 開発者ガイド位置情報

Timeline itemの中でユーザーの位置情報を確認するためにMirror APIを使うことが出来ます。最新の位置情報を直接リクエストするか、一定間隔で位置情報の更新を購読できます。あなたはMirror APIにて予め描画された地図画像をタイムラインカードに渡すことも出来ます。
注意ユーザーの位置情報を要求するにはさらにNote: Retrieving users' location requires the additional https://www.googleapis.com/auth/glass.locationの範囲が必要となります。

位置情報の更新を購読する

Timelineで更新を取得するSubscriptionようにlocations collectionのsubscribingによって位置情報の更新を購読することが出来ます。


POST /mirror/v1/subscriptions HTTP/1.1
Authorization: Bearer {auth token}
Content-Type: application/json
Content-Length: {length}

{
  "collection": "locations",
  "userToken": "harold_penguin",
  "verifyToken": "random_hash_to_verify_referer",
  "callbackUrl": "https://example.com/notify/callback"
}

注意位置情報の更新は10分ごとに通知されます。

Timeline card上に地図を描画する

Google Mirror APIは地図を描画して、重要な場所と経路を示すためにマークと線を重ねることが出来ます。
glass://map URIを使って地図を要求します。
例：


<img src="glass://map?w=width&h=height&marker=0;latitude,longitude&marker=1;latitude,longitude&polyline=;latitude,longitude,latitude,longitude"
  width="width"
  height="height"/>

注意常にwidthとheightをimgタグに入れて下さい。これにより地図画像が再描画されるのを防ぎます。
必須パラメータの詳細：
w 返される地図画像のピクセル幅
h 返される地図画像のピクセル高さ

さらに以下のリストのうち最低一つが必要です。あるいは全て指定することも出来ます。
・centerとzoom 描画する地図の中心(緯度、経度)とズームレベルを指定します。ズームレベルのより詳細はGoogle mapsのドキュメント（英語）を参照して下さい
・market ピンマーカーを描画する座標を指定します。markerパラメータは0から始まるindex値、緯度、経度を持ちます。
centerとzoomを指定しなかった場合、地図は自動的に全てのマークをもとに中心とzoomレベルを求めます。
・polyline 地図上に経路を示すために多角形を指定します。　各polylineは幅、色に続けてpolylineの場所を記載します。　例えば
polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 と言う記載は8pxの幅で赤色の線を(47.6,-122.34)から(47.62,-122.40)まで描きます。centerとzoomを指定しなかった場合、polylineは自動的に地図のセンターになり、ちょうどフィットするサイズにzoomされます。

以下の例は地図といくつかのテキストを描画する最適な方法の例です。


<article>
  <figure>
    <img src="glass://map?w=240&h=360&marker=0;42.369590,
      -71.107132&marker=1;42.36254,-71.08726&polyline=;42.36254,
      -71.08726,42.36297,-71.09364,42.36579,-71.09208,42.3697,
      -71.102,42.37105,-71.10104,42.37067,-71.1001,42.36561,
      -71.10406,42.36838,-71.10878,42.36968,-71.10703"
      height="360" width="240">
  </figure>
  <section>
    <div class="text-auto-size">
      <p class="yellow">12 minutes to home</p><p>Medium traffic on Broadway</p>
    </div>
  </section>
</article>

注意　あなたは上記の例のようにpolylineの色と幅を省略できます。地図はこの場合標準の色と幅を使って描画します。

最終更新日2013年4月16日
＜Google Glass 開発者ガイド Subscriptions ｜Google Glass 開発者ガイド Contacts ＞

Google Glass 開発者ガイド位置情報