2D タイルの概要

ロードマップの例マップタイルとは、世界をインデックス付きのグリッドに分割することです。これにより、複数の地図作成スケールで地図データに効率的かつ動的にアクセスして利用できます。Map Tiles API を使用すると、Google がキュレートしたデータセットを含む、複数のテーマ別地理データセットにアクセスできます。

  • Google の地図作成スタイルを使用したベクター地形データに基づくロードマップの画像タイル。

  • 衛星と航空機の両方のカメラで撮影されたオルソ写真。地球の真上から（天底）画像を撮影します。

  • 陰影起伏図。

2D 地図タイルはすべてジオ参照され、互いに位置揃えされます。ビューポートの地理的範囲とズームレベルに基づいて選択されます。ズームレベルは 0（世界全体を表示）から 22（街路や街並みを表示）までの範囲で設定できます。

地図のテーマ

次の地図テーマの地図タイルを取得できます。

地図のテーマ 説明
ロードマップ 道路、建物、スポット、行政境界
衛星 宇宙から撮影された写真画像
地形 植生などの自然の特徴を示す等高線マップ

Map Tiles API から地図タイルをリクエストするには、まずセッション トークンをリクエストする必要があります。セッション トークンは、地図とビューポートの現在の状態をトラッキングします。セッション トークンを設定するときは、必要な地図のテーマと一致するように mapType 値を設定する必要があります。次に、Map Tiles API に対する各リクエストにセッション トークンを含める必要があります。

ビューポート情報のリクエスト

ビューポートは、世界のシーンを囲むボックスのサイズを定義します。ビューポート情報リクエストでは、現在のビューポートを構成する地図タイルに関する詳細情報が返されます。ビューポート情報をリクエストするのは、存在しないズームレベルの画像はリクエストしないためです。

たとえば、ほとんどの都市ではズームレベル 22 の画像がありますが、海ではなく青い正方形が表示されるだけなので、海の画像は表示されません。

ビューポート リクエストは、次の形式の HTTPS GET リクエストです。

curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&zoom=zoom&north=north&south=south&east=east&west=west"

リクエストには次のフィールドが含まれます。

zoom
ビューポートのズームレベル。
north、south、east、west
度数で表される、ビューポート内の最も遠い北、南、東、西のポイント。北と南は（-90,90）の範囲に、東と西は（-180, 180）の範囲内にする必要があります。経度 170 度線をまたぐ境界を表現するには、西を正（170 など）に、東を負（-170 など）にすることができます。すべてのパラメータは必須です。

ビューポート情報のレスポンス

ビューポートのレスポンスでは、画像がある領域とズームレベルがわかります。ビューポート情報のレスポンスの形式は次のとおりです。

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    {
      "maxZoom": 9,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    {
      "maxZoom": 14,
      "north": 84.375,
      "south": -84.375,
      "east": 180,
      "west": -180
    }, ...
  ]
}

レスポンスの本文には次のフィールドがあります。

copyright
道路地図タイルと衛星タイルを表示するときに地図に表示する必要がある帰属情報文字列を指定します。詳しくは、Map Tiles API のポリシーをご覧ください。
maxZoomRect
現在のビューポートと重なる境界長方形の配列が格納されます。各長方形内で使用できる最大ズームレベルも含まれます。

タイル座標関数

ほとんどのプログラミング言語では、ツール（単純な関数）を使用して、緯度と経度のペアを特定のズームレベルのタイル座標に変換できます。次の JavaScript コードの例では、まず latLng からポイントに変換し、次にポイントからタイル座標に変換します。

var TILE_SIZE = 256;

function fromLatLngToPoint(latLng) {
  var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
  return {
    x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
    y: TILE_SIZE / 2 * (1 +  mercator / Math.PI)
  };
}

function fromLatLngToTileCoord(latLng, zoom) {
  var point = fromLatLngToPoint(latLng);
  var scale = Math.pow(2, zoom);

  return {
    x: Math.floor(point.x * scale / TILE_SIZE),
    y: Math.floor(point.y * scale / TILE_SIZE),
    z: zoom
  };
}