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

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

Map Tiles API では、セッション トークンは定義された一連の 表示オプションが表示されます。表示オプションの集合を リクエストできます。複数のクライアントで同じセッション トークンを使用できます。 セッション トークンは現在、トークンの有効期限から 2 週間有効です。 ただし、この状況は変更される可能性があります。セッション トークンの有効期限は、レスポンス メッセージの expiry フィールドでいつでも確認できます。

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

セッション トークンをリクエストするには、次の例に示すように、createSession エンドポイントに HTTPS POST リクエストを送信します。このリクエストは、 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 倍 スケール係数 2x 高 DPI
通常の解像度で表示された地図 2 倍の高 DPI 解像度で表示された地図
layerTypes

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

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

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

overlay

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

たとえば、layerRoadmap レイヤで satellite マップタイプをリクエストし、overlayfalse に設定すると、Maps JavaScript API で使用されている hybrid マップタイプと同等のタイルが生成されます(左の画像)。同じ overlaytrue に設定したマップタイプとレイヤタイプでは、透明なタイルが表示される 航空写真に重ねるのに適したスタイルが適用された地図オーバーレイ (右の画像)。

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)。