ロードマップ タイルは、Google の地図作成スタイル設定を適用した、ベクター地形データに基づく画像タイルです。これには、道路、建物、スポット、行政境界が含まれます。
ロードマップ タイルを取得する
セッション トークンを取得したら、ロードマップ タイルのリクエストを開始できます。セッション トークンはセッション全体に適用されるため、タイル リクエストでマップ オプションを指定する必要はありません。
次のコードサンプルは、ロードマップタイルの一般的なセッション トークン リクエストを示しています。
curl -X POST -d '{ "mapType": "roadmap", "language": "en-US", "region": "US" }' \ -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 &orientation=0_or_90_or_180_or_270"
この HTTPS GET リクエストでは、z
はズームレベル(0 ~ 22 の範囲)、x
と y
は取得するタイルのタイル座標です。
orientation
パラメータは省略可能です。この値は、タイル画像が反時計回りに回転する度数を指定します。orientation
は roadmap
タイルでサポートされます。また、"overlay": true
でベース画像が削除され、layerTypes
が設定された衛星と地形のリクエストでもサポートされています。有効な orientation
値は 0(デフォルト)、90、180、270 です。
orientation
値を指定しても、タイル座標グリッドは回転しません。たとえば、orientation
を 90 に設定しても、x
座標はタイルの左から右の位置(この場合は地図の北から南)を定義します。
0 度方向 | 90 度回転 |
---|---|
タイル リクエストの例
世界全体を含む単一のタイルをリクエストする次の例について考えてみましょう。この例では、ズームレベルは 0、x 座標と y 座標は 0, 0 です。
curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png
この例では、サーバーからのレスポンス メッセージはありません。代わりに、タイルは、次の統計情報とともにローカル ファイルにダウンロードされます。
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 8335 100 8335 0 0 51471 0 --:--:-- --:--:-- --:--:-- 54835
レスポンス メッセージ ヘッダーの詳細については、コンテンツのプリフェッチ、キャッシュ保存、保存をご覧ください。