地形タイル

地形タイルの概要地形タイルは、陰影起伏図と等高線を含む画像タイルです。植生などの自然特性が含まれます。

地形タイルの取得

セッション トークンを取得したら、地形タイル リクエストを開始できます。セッション トークンはセッション全体に適用されるため、タイル リクエストでマップ オプションを指定する必要はありません。

次のコードサンプルは、地形タイルに対する一般的なセッション トークン リクエストを示しています。

curl -X POST -d '{
  "mapType": "terrain",
  "language": "en-US",
  "region": "US",
  "layerTypes": ["layerRoadmap"]
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

地形タイルを取得するには、次の例に示すように HTTPS GET リクエストを送信します。

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY

タイル リクエストの例

次の例では、ズームレベル 10 の単一の地形タイルをリクエストしています。x 座標と y 座標は（192、401）です。

curl "https://tile.googleapis.com/v1/2dtiles/10/192/401?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

この例では、サーバーからのレスポンス メッセージはありません。代わりに、タイルはローカル ファイルにダウンロードされます。

地形タイル ダウンロード レスポンス

レスポンス メッセージ ヘッダーの詳細については、コンテンツのプリフェッチ、キャッシュ保存、保存をご覧ください。