2026年11月15日、PythonでWebの地図を描けるライブラリFoliumの1.0.0が公開されました。2025年6月16日の0.20.0から、およそ1年5か月ぶりの新しい版です。
長く0.x系で開発されてきたFoliumが、ついに1.0に到達しました。PyPIの記録によると、必要なPythonは3.11以上になっています。
ほかにも、3Dの地球儀を描くプラグインや、pandasのデータで位置を渡せる機能などが加わりました。今回は、0.20.0と1.0.0で同じコードを動かしながら、何が変わったのかを見ていきます。
まずはFoliumとはどんなものか¶
最初に、Foliumを知らない方のために、どんなライブラリなのかを簡単に紹介します。Foliumは、Pythonのコードから、ブラウザで動かせる地図を作るライブラリです。
内部では、Leafletという、Webの地図を表示するためのJavaScriptのライブラリを使っています。Pythonで地図を組み立てると、Leafletを使ったHTMLのファイルを書き出してくれる仕組みです。
最小の地図を作ってみた¶
実際に、東京駅にマーカーを立てた地図を作ってみました。1.0.0を入れた仮想環境で、手元のPython 3.11を使っています。
import folium
m = folium.Map(location=[35.681, 139.767], zoom_start=13)
folium.Marker([35.681, 139.767], popup="東京駅").add_to(m)
m.save("map.html")
できあがったmap.htmlをブラウザで開くと、拡大や移動ができる地図の上に、マーカーが表示されます。locationには、緯度と経度の順番で、位置を渡します。
数行のPythonで、動かせる地図が作れるのがFoliumの手軽なところです。Jupyter Notebookの中では、mをセルの最後に書くだけで地図が表示されます。
ほかの可視化の道具との違い¶
Pythonでデータを図にする道具は、ほかにもあります。地図に関しては、次のような違いがあります。
| 道具 | 得意なこと |
|---|---|
| Matplotlib | 紙やスライドに貼る、静止画のグラフ |
| Folium | 拡大や移動ができる、Webの地図 |
| Plotlyなど | 操作できるグラフ全般。地図も描ける |
グラフづくりの基本は、こちらで紹介しています。【関連記事】PythonのMatplotlibとは?
1.0で何が変わったのかを整理しよう¶
続いて、1.0.0の主な変更を表にまとめます。内容は、FoliumのGitHubにある1.0.0のリリースノートにもとづいています。
| 分類 | 主な変更 |
|---|---|
| 対応範囲 | Python 3.11より古い版のサポートを終了 |
| 新しいプラグイン | 3Dの地球儀WebGLEarth、線に矢印などを付けるPolyLineDecorator |
| 新機能 | ラベル付きのpandasのSeriesを、位置として渡せる |
| 新機能 | マーカーのアイコンの背景に、16進数の色を指定できる |
| 新機能 | LayerGroupに対応し、地図の重なりをまとめて扱える |
| 依存ライブラリ | Leafletを1.9.3から1.9.4に更新 |
リリースノートは、取り込まれた変更の一覧という形で、互換性を壊す変更や削除された機能の見出しはありませんでした。7月26日には、1.0.0の前の試験版v1.0.0-pre.1も公開されていました。
Python 3.11以上が必要に¶
まずは、使う環境に関わる変更から見ていきましょう。リリースノートには、サポートの終わったPython 3.11より古い版を外す、という変更が含まれています。
PyPIの記録でも、1.0.0が必要とするPythonは3.11以上でした。3.10以下でpip install foliumを実行すると、1.0.0ではなく、それより前の版が入ることになります。
主要なライブラリがPython 3.10を外していく流れは、こちらでもまとめました。【関連記事】Python 3.10のサポート終了から2週間、主要ライブラリの対応状況
pandasのSeriesで位置を渡せるように¶
続いて、データ分析をしている人に嬉しい変更です。リリースノートによると、ラベル付きのpandasのSeriesを、位置として渡せるようになりました。
0.20.0と1.0.0で試してみた¶
実際に、latとlonというラベルを持つSeriesで、マーカーを立ててみました。
import folium
import pandas as pd
m = folium.Map(location=[35.681, 139.767], zoom_start=13)
s = pd.Series({"lat": 35.658, "lon": 139.745})
folium.Marker(s).add_to(m)
0.20.0と1.0.0を、それぞれ新しい仮想環境に入れて実行した結果です。
folium 0.20.0
TypeError: Location should support indexing, like a list or a tuple does, instead got lat ...
folium 1.0.0
(エラーなくマーカーが追加された)
0.20.0では、リストやタプルのように番号で取り出せるものを渡すよう、TypeErrorになりました。1.0.0では、そのまま位置として受け付けられています。
何が嬉しいのか¶
位置の情報は、CSVなどから読み込んで、pandasのDataFrameで扱うことがよくあります。1行ずつ取り出したSeriesを、変換せずにそのまま渡せるようになったわけです。
pandasの基本は、こちらで紹介しています。【関連記事】Pythonのpandasとは?
マーカーに好きな色を付けられるように¶
3つ目は、マーカーのアイコンの色です。リリースノートによると、アイコンの背景に、#ff8800のような16進数の色を指定できるようになりました。
0.20.0と1.0.0で試してみた¶
実際に、folium.Icon(color="#ff8800")でアイコンを作り、出た警告を確かめました。
| 版 | 警告 |
|---|---|
| 0.20.0 | color argument of Icon should be one of: ... という警告が出た |
| 1.0.0 | 警告は出なかった |
0.20.0では、redやblueなど、決められた名前の色のどれかを使うよう警告されました。1.0.0では、16進数の色が、そのまま受け付けられています。
会社や学校のロゴの色に合わせるなど、決まった色をマーカーに使いたいときに便利です。
新しいプラグイン¶
1.0.0では、新しいプラグインも加わりました。プラグインとは、foliumのpluginsから読み込んで使う、追加の機能のことです。
| プラグイン | できること |
|---|---|
| WebGLEarth | 地図を、回せる3Dの地球儀として表示する |
| PolyLineDecorator | 地図に引いた線に、矢印などの模様を付ける |
手元でhasattr(plugins, "WebGLEarth")のように確かめると、0.20.0ではどちらもFalse、1.0.0ではどちらもTrueでした。PolyLineDecoratorは、移動の向きを矢印で示したいときなどに使えそうです。
PolyLineDecoratorで線に矢印を付けてみた¶
実際に、東京駅から東京タワーの近くまで線を引き、その真ん中に矢印を付けてみました。インストールされた1.0.0の説明文を参考に、模様の指定を辞書のリストで渡しています。
import folium
from folium import plugins
m = folium.Map(location=[35.67, 139.756], zoom_start=13)
line = folium.PolyLine([[35.681, 139.767], [35.658, 139.745]], color="blue").add_to(m)
plugins.PolyLineDecorator(
line,
[{"offset": "50%", "repeat": 0, "symbol": {"type": "arrowHead", "pixel_size": 15}}],
).add_to(m)
m.save("route.html")
offsetは矢印を置く位置で、50%なら線の真ん中です。repeatを0にすると、矢印は1つだけになります。
symbolのtypeには、矢印のarrowHead、点線のdash、マーカーのmarkerの3つが使えます。試しにstarと書いてみると、次のようなエラーになりました。
ValueError: symbol type should be one of ['arrowHead', 'dash', 'marker'], got 'star'
使える種類を、エラーの文面で教えてくれるので、書き間違えてもすぐに気づけます。なお、最初に模様を文字列だけで渡してみたところ、辞書ではないためにValueErrorになりました。
WebGLEarthの地球儀¶
WebGLEarthも、plugins.WebGLEarth(center=[35.681, 139.767], zoom=4).add_to(m)の形で地図に加えられました。保存したHTMLを見ると、webglearth.comのJavaScriptを読み込む形になっていました。
インストールされたコードの説明では、地球儀にマーカーを立てるWebGLEarthMarkerも用意されています。ブラウザで開くには、外部のJavaScriptを読み込めるネットワークが必要な点に気をつけましょう。
そのほかの修正¶
リリースノートには、ほかにもたくさんの修正が並んでいます。初心者にも関係しそうなものを、表にまとめます。
| 修正 | 中身 |
|---|---|
| GeoJSONの読み込み | 地域の設定に関係なく、UTF-8で読み込むように |
| ポップアップの文字 | バックスラッシュを含む文字が、正しく表示されるように |
| 保存 | map.save()を何度も呼ぶと、HTMLが重複することがあった問題を修正 |
| ヒートマップ | 整数のnumpy配列の重みで、落ちる問題を修正 |
依存するLeafletの更新も、手元で確かめました。同じ地図を書き出したHTMLの中で、読み込むLeafletの版は、0.20.0では1.9.3、1.0.0では1.9.4になっていました。
1つ目は、Windowsで日本語を含むGeoJSONのファイルを読むときに、関係があるかもしれません。GeoJSONは、地図の形や位置をJSONで表す形式です。
JSONの扱いについては、こちらで紹介しています。【関連記事】PythonでJSONデータの扱いをマスター
上げる前にやっておきたいこと¶
最後に、Foliumを1.0.0へ上げる前に確かめておきたいことを整理します。
| 順番 | 確認すること |
|---|---|
| 1 | Python 3.11以上を使っているか |
| 2 | 作った地図を開いて、見た目が変わっていないか |
| 3 | Series用に、位置をリストへ変換していた処理を、簡単にできないか |
| 4 | 決められた色に置き換えていたマーカーを、本来の色に戻せないか |
私は10年ほどエンジニアとして開発に関わってきましたが、営業の担当者向けに、取引先の場所を地図に並べる社内ツールをFoliumで作ったことがあります。CSVから読んだ住所の位置をそのまま地図に載せられて、とても喜ばれました。
まとめ¶
2026年11月15日、Folium 1.0.0が公開され、ついに1.0に到達しました。Python 3.11以上が必要になり、3Dの地球儀のプラグインや、pandasのSeriesで位置を渡せる機能、16進数の色のアイコンなどが加わっています。
数行で動かせる地図が作れる手軽さは、そのままです。この機会に、身近な場所の地図を作ってみてはいかがでしょうか。
ここまでお読みいただきありがとうございました。