dietrichmax/docker-staticmaps

これは何？

主な機能

• 01静的地図にマーカー、ポリゴン、円、ポリライン、テキストを重ねて表示
• 02OpenStreetMap、Esri、Cartoのベースマップとカスタムタイルサーバーに対応
• 03Terrarium形式でエンコードされたDEMタイルによるヒルシェードレイヤーを任意で追加
• 04タイルと生成画像をキャッシュ
• 05IPごとのレート制限と任意のAPIキー認証を適用
• 06ブラウザ上のプレイグラウンドを備えたDockerイメージとして提供

ユースケース

• JavaScriptの地図を読み込まずに、メール、レポート、通知へ地図プレビューを埋め込む
• ダッシュボードやサーバーサイドレンダリングのページ用に位置情報の画像を生成する
• ルート、エリア、地点群を示す地図のサムネイルを一覧用に作成する
• 自前のインフラでプライベートな静的地図サービスを運用する

クイックスタート

1. 1

   DockerでAPIを起動する

   docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest
2. 2

   サンプルの地図画像をリクエストする

   curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite"
3. 3

   ブラウザーでインタラクティブなプレイグラウンドを開く

使う前に知っておきたいこと

• !ソースコードはAGPL-3.0+でライセンスされており、変更してホストする場合は強いコピーレフト要件が適用されます。

収録されている特集

トピック

よくある質問

docker-staticmaps とは？

マーカーやポリゴンなどを重ねた静的地図画像を生成する、セルフホスト可能なREST API。 Docker Static Maps APIは、RESTエンドポイントから静的地図画像を生成するセルフホスト可能なサービスです。呼び出し側はクエリ文字列でサイズ、中心座標、ズームレベル、ベースマップを指定し、マーカー、ポリゴン、円、ポリライン、テキストを画像に重ねられます。

docker-staticmaps は無料で使えますか？ライセンスは？

docker-staticmaps は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

docker-staticmaps は今もメンテナンスされていますか？

活発にメンテナンス中。docker-staticmaps の最終コミットは 2026年11月6日 です。

docker-staticmaps は何に使えますか？

JavaScriptの地図を読み込まずに、メール、レポート、通知へ地図プレビューを埋め込む ダッシュボードやサーバーサイドレンダリングのページ用に位置情報の画像を生成する ルート、エリア、地点群を示す地図のサムネイルを一覧用に作成する 自前のインフラでプライベートな静的地図サービスを運用する

docker-staticmaps のインストール方法は？

DockerでAPIを起動する: docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest サンプルの地図画像をリクエストする: curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite" ブラウザーでインタラクティブなプレイグラウンドを開く

docker-staticmaps はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/dietrichmax/docker-staticmaps