Python WebAcademy

Python WebAcademy Blog

地図を描くPythonのライブラリFolium 1.0がリリース。Python 3.11以上が必要になり、3Dの地球儀やpandasのデータで位置を渡せるようになったニュースを初心者向けに解説

|

2026年11月15日、PythonでWebの地図を描けるライブラリFoliumの1.0.0が公開されました。2025年6月の0.20.0から、およそ1年5か月ぶりの新しい版で、ついに1.0に到達しています。Python 3.11以上が必要になり、3Dの地球儀のプラグインや、pandasのSeriesで位置を渡せる機能などが加わりました。0.20.0と1.0.0で動かした結果とともに整理します。

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進数の色のアイコンなどが加わっています。

数行で動かせる地図が作れる手軽さは、そのままです。この機会に、身近な場所の地図を作ってみてはいかがでしょうか。

ここまでお読みいただきありがとうございました。

参考情報

次のアクション

記事で学んだ内容を実際に動かしてみよう

Python WebAcademyでは、ブラウザ上でコードを書きながら基礎から実践まで体系的に学べます。

Python WebAcademyの学習画面

あわせて読む

関連記事

ブログ一覧へ

Python学習ロードマップ

まずはこの3講座から

記事で気になったテーマを、順番に手を動かしながら学べます。

ロードマップを見る