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

セッション トークンとは、 UUID） これは、REST 呼び出しで使用され、 session 一連の関連メッセージをやり取りできますすべてのメッセージにセッション トークンを含める必要があります。 2D タイルとストリートビュー画像のリクエストも受け付けています。 すべてのリクエストに追加する session パラメータの値として追加します。 できます。

Map Tiles API では、セッション トークンは定義された一連の 表示オプションが表示されます。つまり、SDK で表示オプションの集合を渡さなくても、 リクエストできます。複数のクライアントで同じセッション トークンを使用できます。 セッション トークンは現在、トークンの有効期限から 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

共通の言語 / 地域データ リポジトリ 物理的な場所を表す地域識別子（2 文字の大文字） できます。例: US

省略可能項目

imageFormat
返されるファイル形式を指定します。有効な値は jpeg または png です。 JPEG ファイルは透過性に対応していないため、 オーバーレイ タイルです。imageFormat を指定しない場合、 タイルが自動的に選択されます。
scale

道路のラベルなどの地図要素のサイズをスケールアップし、 デフォルト タイルのタイルサイズとカバレッジ エリア。スケールを上げると 地図上のラベルの数を減らし、見やすくします。次の 値は有効な scale 値です。

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

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

スケーリング ファクタ 1 倍 スケール ファクタ 2 倍
縮尺 1 倍を示す地図 縮尺 2 倍を示す地図
highDpi
高解像度のタイルを返すかどうかを指定します。scale-factor が 大きい場合、highDpi を使用してタイルのサイズを大きくします。通常、 スケール係数を大きくすると、結果のタイルが 画質が低下します。highDpi を使用すると、結果のサイズも次のようになります。 品質を維持します。DPI は 1 インチあたりのドット数を表し、高 DPI は タイルが通常よりも 1 インチあたりのドット数が増えます。true の場合、 x 次元と y 次元それぞれのピクセル数に scale を乗じる 係数（つまり、2x または 4x）で表現されます。タイルのカバレッジ エリアは変更されません。 このパラメータは、scale 値が 2x または 4x の場合にのみ機能します。クラウド リソースに 1x スケールタイル。
スケーリング ファクタ 1 倍 スケール ファクタ 2 倍の高 DPI
通常の解像度で表示された地図 2 倍の高 DPI 解像度で表示された地図
layerTypes

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

layerRoadmap
マップタイプとして terrain を指定する場合は必須。オプション satellite マップタイプに重ねて表示されます。ロードマップ タイルには影響しません。
layerStreetview
ストリートビューが有効になっている道路や場所を、青い枠線で示されます 提供します
layerTraffic
現在の交通状況を表示します。
styles

JSON スタイル オブジェクトの配列です。このオブジェクトの外観と詳細レベルが 地図対象物（道路、公園、市街地など）を作成します。スタイルは 標準の Google 基本地図をカスタマイズします。styles パラメータは、次の場合にのみ有効です。 マップタイプは roadmap です。すべてのスタイルの構文については、 スタイル リファレンス。

overlay

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

たとえば、layerRoadmap レイヤを含む satellite マップタイプをリクエストします。 overlay を false に設定すると、hybrid のマップタイプと同等のタイルが表示されます Maps JavaScript API で使用（左の画像）。同じ 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" }
      ]
    }
  ]
}

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

apiOptions: 適用する追加のオプションを指定する値の配列。 使用可能なオプションは次のとおりです。

  • MCYJ5E517XR2JC - 新しい地図 スタイル。オプトイン期間中は、リクエストに既存の スタイルを選択します。

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

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

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

レスポンスの本文のフィールドの定義は次のとおりです。

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