gdal2tiles
TMSタイルが格納されたディレクトリ,KML,簡易ウェブビューアを生成します.
概要
gdal2tiles [--help] [--help-general]
[-p <profile>] [-r resampling] [-s <srs>] [-z <zoom>]
[-e] [-a nodata] [-v] [-q] [-h] [-k] [-n] [-u <url>]
[-w <webviewer>] [-t <title>] [-c <copyright>]
[--processes=<NB_PROCESSES>] [--mpi] [--xyz]
[--tilesize=<PIXELS>] --tiledriver=<DRIVER> [--tmscompatible]
[--excluded-values=<EXCLUDED_VALUES>]
[--excluded-values-pct-threshold=<EXCLUDED_VALUES_PCT_THRESHOLD>]
[--nodata-values-pct-threshold=<NODATA_VALUES_PCT_THRESHOLD>]
[-g <googlekey] [-b <bingkey>] <input_file> [<output_dir>] [<COMMON_OPTIONS>]
説明
このユーティリティは,小さなタイルとメタデータを含むディレクトリを生成し,OSGeoタイルマップサービス仕様に従います.Google Maps,OpenLayers,Leafletをベースにした簡単なウェブページとビューアも生成されるため,誰でも快適にオンラインで地図を探索でき,特別なソフトウェア(例えばMapServer)をインストールしたり設定したりする必要がなく,ウェブブラウザで地図が非常に速く表示されます.生成されたディレクトリをウェブサーバーにアップロードするだけです.
GDAL2Tilesは,提供された地図がEPSG:4326投影法を使用している場合、Google Earth用の必要なメタデータ(KML SuperOverlay)も作成します.
タイル生成中にワールドファイルと埋め込みジオリファレンスが使用されますが,適切なジオリファレンスがない画像を公開することもできます.
注釈
非バイトデータ型(つまり Int16, UInt16,...)の入力は Byte データ型にクランプされ,誤った結果を引き起こします. これを避けるためには, gdal_translate ユーティリティを使用して入力を Byte データ型にスケーリングする必要があります.
注釈
入力ドライバの設定オプションは, gdal2tilesの出力に影響を与える可能性があります.ドライバの設定オプションの例は, GDAL_PDF_DPI であり, 設定オプション で見つけることができます.
注釈
gdal2tiles は Python ユーティリティであり, GDAL Python バインディングが利用可能な場合のみ利用できます.
- --help
このヘルプメッセージを表示して終了します
- --help-general
一般的な GDAL コマンドラインオプションの使用方法を簡単に表示して終了します.
- -p <PROFILE>, --profile=<PROFILE>
タイルカットプロファイル(mercator, geodetic, raster) - デフォルトは 'mercator' (Google Maps 互換).
GDAL 3.2 以降, GDALデータディレクトリに配置された tms_XXXX.json ファイルから追加のプロファイルが利用可能です(すべてのズームレベルが同じ原点,タイルサイズ,および連続するズームレベル間の解像度が2倍の因子で変化することが前提です).
- -r <RESAMPLING>, --resampling=<RESAMPLING>
リサンプリング方法(average, near, bilinear, cubic, cubicspline, lanczos, antialias, mode, max, min, med, q1, q3) - デフォルトは 'average'.
- -s <SRS>, --s_srs=<SRS>
ソース入力データに使用される空間参照システムです.
- --xyz
TMSの代わりにXYZタイル(OSM Slippy Map標準)を生成します. デフォルトモード(TMS)では, y=0 のタイルは最南端のタイルですが,XYZモード(OGC WMTSも使用)では, y=0 のタイルは最北端のタイルです.
Added in version 3.1.
- -d, --tmscompatible
geodeticプロファイルを使用する場合,基本解像度を0.703125またはズームレベル0の2タイルとして指定します.
- -z <ZOOM>, --zoom=<ZOOM>
レンダリングするズームレベル(フォーマット:'2-5', '10-' または '10').
- -e, --resume
再開モード. 不足しているファイルのみを生成します.
- -a <NODATA>, --srcnodata=<NODATA>
入力データセットで透明と見なされる値です. 入力データセットにすでに関連付けられたノーデータ値がある場合,指定された値で上書きされます.
- -v, --verbose
タイル生成の詳細な出力を生成します.
GDAL 3.7 以降,その詳細な出力は
logging.getLogger("gdal2tiles")オブジェクトを介して出力されます.
- -x, --exclude
透明タイルを結果のタイルセットから除外します.
- -q, --quiet
メッセージとステータスを標準出力に無効にします
Added in version 2.1.
- --processes=<NB_PROCESSES>
計算を高速化するためにタイリングに使用する並列プロセスの数です.
Added in version 2.3.
- --mpi
mpiexecによって起動されたと仮定し, MPI並列処理を有効にして --processes を無視します.動作するMPI環境とMPI for Python(mpi4py)パッケージが必要です. ユーザーは,ノードあたりのメモリとノードあたりに起動されたプロセスの数に基づいて適切なキャッシュサイズを設定する必要があります.
Added in version 3.5.
- --tilesize=<PIXELS>
タイルの幅と高さ(ピクセル)です. デフォルトは 256 です.
Added in version 3.1.
- --tiledriver=<DRIVER>
タイルの出力ドライバを指定し,タイルのファイル形式を決定します. 現在, PNG, WEBP, JPEG(JPEGはGDAL 3.9で追加)がサポートされています.デフォルトは PNG です. WEBPおよびJPEGドライバの追加構成は以下に記載されています.
Added in version 3.6.
- --excluded-values=<EXCLUDED_VALUES>
リサンプリング中に寄与するソース * ピクセルとして無視される値のカンマ区切りのタプル(通常は "R,G,B")です.タプル内の値の数は,アルファバンドを除いたバンドの数と同じである必要があります.複数の除外値タプルを "(R1,G1,B2),(R2,G2,B2)" 構文を使用して指定できます.現在は平均のみが考慮されます. この概念はノーデータ/アルファに少し似ていますが,主な違いは,除外値タプルのいずれかに一致するピクセルは,ターゲットピクセルの有効性/密度を決定する際に有効として考慮される点です.
Added in version 3.9.
- --excluded-values-pct-threshold=EXCLUDED_VALUES_PCT_THRESHOLD
除外値の一つで設定されているソースピクセルの最小パーセンテージは,ソースピクセルの多数派である除外値をターゲットピクセル値として使用するために必要です.デフォルト値は 50(%) です.
Added in version 3.9.
- --nodata-values-pct-threshold=<NODATA_VALUES_PCT_THRESHOLD>
ターゲットピクセル値を透明にするために,ノーデータ(またはアルファ=0または透明ピクセルを表現する他の方法)に設定されているソースピクセルの最小パーセンテージは,100(%) です. これは,すべての寄与ソースピクセルが透明である場合にのみ,ターゲットピクセルが透明になることを意味します.平均リサンプリングのみが考慮されます.
Added in version 3.9.
- -h, --help
ヘルプメッセージを表示して終了します.
- --version
プログラムのバージョン番号を表示して終了します.
KMl(Google Earth)オプション
生成されたGoogle Earth SuperOverlayメタデータのオプション
- -k, --force-kml
Google Earth用のKMLを生成します - 'geodetic'プロファイルとEPSG:4326の'raster'のデフォルトです.異なる投影法のデータセットの場合は注意して使用してください!
- -n, --no-kml
EPSG:4326のKMLファイルの自動生成を回避します.
- -u <URL>, --url=<URL>
生成されたタイルが公開されるURLアドレスです.
ウェブビューアオプション
Google Maps風の生成されたHTMLビューアのオプション
- -w <WEBVIEWER>, --webviewer=<WEBVIEWER>
生成するウェブビューア(all, google, openlayers, leaflet, mapml, none) - デフォルトは 'all'.
- -t <TITLE>, --title=<TITLE>
地図のタイトルです.
- -c <COPYRIGHT>, --copyright=<COPYRIGHT>
地図の著作権です.
- -g <GOOGLEKEY>, --googlekey=<GOOGLEKEY>
http://code.google.com/apis/maps/signup.html からのGoogle Maps APIキーです.
- -b <BINGKEY>, --bingkey=<BINGKEY>
https://www.bingmapsportal.com/ からのBing Maps APIキーです.
MapMLオプション
MapMLサポートはGDAL 3.2で新しくなりました. --webviewer=mapml が指定されている場合, --xyz が暗黙的に指定されます.--profile=geodetic の場合, --tmscompatible も暗黙的に指定されます.
以下のプロファイルがサポートされています:
mercator: OSMTILE MapMLタイリングスキームにマッピングされます
geodetic: WGS84 MapMLタイリングスキームにマッピングされます
APSTILE: tms_MapML_APSTILE.json データファイルから
出力ディレクトリに生成されるMapMLファイルは mapml.mapl です
利用可能なオプションは:
- --mapml-template=<filename>
変数が置換されるテンプレートmapmlファイルのファイル名です. 指定されていない場合, GDALデータリソースからの一般的なテンプレート_tiles.mapmlファイルが使用されます
--url オプションは,テンプレートMapMLファイル内の ${URL} を置換するためにも使用されます.
WEBPオプション
WEBPタイルドライバサポートはGDAL 3.6で新しくなりました. --tiledriver=WEBP を使用して有効になります.
WebP出力をさらにカスタマイズするための以下の構成オプションが利用可能です:
- --webp-quality=<QUALITY>
QUALITY は 1-100 の整数です. デフォルトは 75 です.
- --webp-lossless
WEBPロスレス圧縮を使用します. デフォルトはロスレスではありません
注釈
GDAL WEBPドライバ ドキュメントを参照できます
JPEGオプション
JPEGタイルドライバサポートはGDAL 3.9で新しくなりました. --tiledriver=JPEG を使用して有効になります.
JPEGは透過をサポートしていないため,エッジタイルはソースラスターでカバーされていない領域に黒いピクセルが表示されます.
JPEG出力をさらにカスタマイズするための以下の構成オプションが利用可能です:
- ---jpeg-quality=JPEG_QUALITY
QUALITY は 1-100 の整数です. デフォルトは 75 です.
例
基本的な例:
gdal2tiles --zoom=2-5 input.tif output_folder
MapML生成:
gdal2tiles --zoom=16-18 -w mapml -p APSTILE --url "https://example.com" input.tif output_folder
MPIの例:
mpiexec -n $NB_PROCESSES gdal2tiles --mpi --config GDAL_CACHEMAX 500 --zoom=2-5 input.tif output_folder