マップタイルは、世界をインデックス付きのグリッドに分割したものです。これにより、複数の地図スケールで地図データに効率的かつ動的にアクセスして利用できます。Map Tiles API を使用すると、Google がキュレートした次のデータセットを含む、複数のテーマ別地理データセットにアクセスできます。
ベクター地形データに基づくロードマップ画像タイル。Google の地図スタイルが適用されています。
衛星カメラと航空カメラの両方で撮影されたオルソ写真。地球のトップダウン（直下）画像を提供します。
陰影起伏等高線図。
2D Map Tiles はすべて地理参照され、相互に位置が調整されています。これらは、ビューポートの地理的範囲とズームレベルに基づいて選択されます。ズームレベルの範囲は 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 など）にします。すべてのパラメータが必須です。
ビューポート情報レスポンス
ビューポート レスポンスは、画像があるエリアとズームレベルを示します。ビューポート情報レスポンスの形式は次のとおりです。
{
"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
};
}