Map Tiles API でセッション トークンを使用する

欧州経済領域（EEA）のデベロッパー

セッション トークンは、セッション（一連の関連するメッセージ交換）を識別するために REST 呼び出しで使用されるデータ（a UUID） です。2D タイルとストリートビューの画像のすべてのリクエストにセッション トークンを含める必要があります。セッション トークンは、すべてのリクエスト URL に追加される session パラメータの値として含めます。

Map Tiles API では、セッション トークンは定義済みの表示オプションのセットを表します。つまり、タイル リクエストごとに表示オプションのセットを渡す必要はありません。同じセッション トークンを複数のクライアントで使用できます。 セッション トークンは、発行日から 2 週間有効ですが、変更される可能性があります。セッション トークンの有効期限は、レスポンス メッセージの expiry フィールドでいつでも確認できます。

セッション トークン リクエスト

セッション トークンをリクエストするには、次の例に示すように、HTTPS POST リクエストを createSession エンドポイントに送信します。リクエストは Content-Type: application/json ヘッダーとともに送信する必要があります。

curl -X POST -d '{
  "mapType": "streetview",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

必須項目

mapType

基本地図のタイプ。この値は、次のいずれかにできます。

roadmap
標準の Google マップの描画された地図タイル。
satellite
衛星画像。
terrain
地形画像。地図タイプとして terrain を選択する場合は、 layerRoadmap レイヤタイプ（ 省略可能項目 セクションで説明）も含める必要があります。
streetview
ストリートビュー パノラマ。詳細については、 ストリートビュー タイルをご覧ください。
language

タイルに情報を表示するために使用される言語を指定する IETF 言語タグ 。たとえば、en-US は、米国で話されている英語を指定します。

region

ユーザーの物理的な場所を表す Common Locale Data Repository の地域識別子（2 文字の大文字）。例: US

省略可能項目

imageFormat
返されるファイル形式を指定します。有効な値は jpeg または png です。 JPEG ファイルは透明度をサポートしていないため、オーバーレイ タイルにはおすすめしません。imageFormat を指定しない場合は、タイルに最適な形式が自動的に選択されます。
scale

地図要素（道路ラベルなど）のサイズを拡大しますが、デフォルトのタイルのタイルサイズとカバレッジ エリアは維持されます。スケールを大きくすると、地図上のラベルの数も減り、雑然とした印象が軽減されます。有効な scale 値は次のとおりです。

  • scaleFactor1x: デフォルト。
  • scaleFactor2x: ラベルサイズを 2 倍にし、マイナーな地物のラベルを削除します。
  • scaleFactor4x: ラベルサイズを 4 倍にし、マイナーな地物のラベルを削除します。

次の例は、地図要素のスケーリングの効果を示しています。

スケール ファクタ 1x スケール ファクタ 2x
スケーリング ファクタ 1x の地図 スケーリング ファクタ 2 倍の地図
highDpi
高解像度タイルを返すかどうかを指定します。スケール ファクタを大きくすると、highDpi を使用してタイルのサイズが拡大されます。通常、スケール ファクタを大きくすると、結果のタイルが同じサイズの画像に拡大され、品質が低下します。highDpi を使用すると、結果のサイズも拡大され、品質が維持されます。DPI は Dots per Inch の略で、High DPI は、タイルが通常の 1 インチあたりのドット数よりも多くのドットを使用してレンダリングされることを意味します。true の場合、x 次元と y 次元のピクセル数がスケール ファクタ（2 倍または 4 倍）で乗算されます。タイルのカバレッジ エリアは変わりません。このパラメータは、scale 値が 2 倍または 4 倍の場合にのみ機能します。1 倍のスケール タイルには影響しません。
スケール ファクタ 1x スケール ファクタ 2x High DPI
通常の解像度で表示された地図 2 倍の高 DPI 解像度で表示される地図
layerTypes

地図に追加されるレイヤタイプを指定する値の配列。有効な値は次のとおりです。

layerRoadmap
地図タイプとして terrain を指定する場合は必須です。satellite 地図タイプに任意で重ね合わせることもできます。ロードマップ タイルには影響しません。
layerStreetview
地図上に青いアウトラインでストリートビュー対応の道路と場所を表示します。
layerTraffic
現在の交通状況を表示します。
styles

道路、公園、市街地などの地図の地物の外観と詳細レベルを指定する JSON スタイル オブジェクトの配列。スタイル設定は、標準の Google 基本地図をカスタマイズするために使用されます。styles パラメータは、地図タイプが roadmap の場合にのみ有効です。完全なスタイル構文については、 スタイル リファレンスをご覧ください。

overlay

layerTypes を個別のオーバーレイとしてレンダリングするか、基本画像と組み合わせてレンダリングするかを指定するブール値。true の場合、基本地図は表示されません。layerTypes を定義していない場合、この値は無視されます。

たとえば、layerRoadmap レイヤで satellite 地図タイプをリクエストし、overlay を false に設定すると、Maps JavaScript API で使用される hybrid 地図タイプ（左の画像）と同等のタイルが生成されます。同じ地図タイプとレイヤタイプで overlay を true に設定すると、地図上のデータ表示を含む透明なタイルが生成され、衛星画像に重ね合わせるように適切にスタイル設定されます（右の画像）。

overlay: false overlay: true
オーバーレイが false に設定されている オーバーレイが true に設定されている

次の JSON は、必須フィールドと省略可能フィールドの両方を含む一般的なリクエスト本文の例です。

{
  "mapType": "satellite",
  "language": "en-US",
  "region": "us",
  "layerTypes": [ "layerRoadmap", "layerStreetview" ],
  "overlay":  true,
  "scale": "scaleFactor1x",
  "styles": [
    {
      "stylers": [
        { "hue": "#00ffe6" },
        { "saturation": -20 }
      ]
    },{
      "featureType": "road",
      "elementType": "geometry",
      "stylers": [
        { "lightness": 100 },
        { "visibility": "simplified" }
      ]
    }
  ]
}

この例では、衛星画像と組み合わせるのに適したオーバーレイを提供します。この例には、ロードマップとストリートビューの両方のオーバーレイが含まれています。結果の地図は、米国で話されている英語で名前とデータがレンダリングされます。

セッション トークン レスポンス

次の JSON は、レスポンス本文の例です。

{
  "session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
  "expiry": "1361828036",
  "tileWidth": 256,
  "tileHeight": 256,
  "imageFormat": "png"
}

次のリストには、レスポンス本文のフィールドの定義が含まれています。

session
すべての Map Tiles API リクエストに含める必要があるセッション トークン値。
expiry
トークンの有効期限が切れる時刻（エポックからの秒数）を含む文字列。セッション トークンは作成日から 2 週間有効ですが、このポリシーは予告なく変更される可能性があります。
tileWidth
タイルの幅（ピクセル単位）。
tileHeight
タイルの高さ（ピクセル単位）。
imageFormat
画像形式（png または jpeg）。