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) の範囲内である必要があります。経度 180 度線をまたぐ境界を表せるように、西は正の値（例: 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
  };
}