---
title: "foliumとは：Pythonで地図を作る使い方とタイルのAPIキー・Access blocked対処【2026年版】"
url: "https://www.issoh.co.jp/tech/details/18049/"
published: 2026-10-03
updated: 2026-10-27
categories: ["Python"]
publisher: "株式会社一創"
---

# foliumとは：Pythonで地図を作る使い方とタイルのAPIキー・Access blocked対処【2026年版】

foliumは、Pythonのコードから地図ライブラリLeafletのHTMLを生成し、拡大・縮小やクリックができる地図を作るライブラリです。2026年10月27日時点の安定版は0.20.0で、7月26日には1.0.0の候補版（rc1）が公開されました。正式版の1.0.0はまだ出ていません。この記事では、インストールとマーカー表示、CSVやGeoJSONのデータを載せる方法、背景タイルで起きる3つの障害（CartoDBの「API KEY REQUIRED」、OpenStreetMapの「Access blocked」、`Stamen Terrain`のエラー）への対処、1万点を描いたときのHTMLサイズ、FlaskやStreamlitへの埋め込みまでを、そのまま動かせるコード付きで整理します。

## まとめ：folium 0.20系の採用条件と背景タイル・データ量の判断基準

foliumで地図を出すまでの手順は短く、`pip install folium`のあとに数行書けばHTMLファイルが手に入ります。つまずくのはコードではなく、背景に敷くタイルです。2026年9月4日の[xyzservices 2026.9.0](https://github.com/geopandas/xyzservices/releases/tag/2026.9.0)からCartoDBのタイルはAPIキーが前提になり、キーなしで`tiles="CartoDB positron"`と書くと、地図の上に「API KEY REQUIRED」の透かしが入ります。古い解説記事にある`tiles="Stamen Terrain"`は、0.20.0では`ValueError`で止まります。

本番の判断は2つに絞れます。社内向けの分析レポートや数千点規模の可視化ならfoliumで十分です。地図上で編集や権限管理が要る、あるいは数十万点を更新し続ける用途なら、foliumを入口にとどめ、地図を扱う業務システムとして設計し直してください。1.0.0rc1は互換性を壊す変更が少ない一方、本番は0.20.0に固定しておくのが無難です。

## foliumの仕組みと0.20系の環境構築からHTML出力までの作業手順

まず、foliumが何を出力しているのかを押さえてから手を動かします。

### LeafletのJavaScriptを生成するfoliumの仕組みとCDN参照版1.9.3

foliumは地図そのものを描画しません。Pythonで組み立てた地図オブジェクトを、Jinja2のテンプレートでLeafletを呼び出すHTMLとJavaScriptに変換するだけです。描画はブラウザ側のLeafletが担い、foliumの0.20.0と1.0.0rc1はどちらもCDNから`leaflet@1.9.3`を読み込みます。Leaflet単体の現行版は1.9.4で、JavaScriptから直接使う方法は[Leafletとは？v1.9.4の使い方と地理院タイル表示、2.0移行とMapLibreとの選び分け](/tech/details/18677/)で扱っています。

この構造から、2つの性質が出てきます。出力したHTMLはサーバーなしで開ける一方、表示にはCDNと背景タイルへのネット接続が必要です。そして、Pythonで扱ったデータはHTMLの中にそのまま埋め込まれるため、データ量がそのままファイルサイズになります。後者は1万点の章で数字を示します。

### pip installでのfolium導入とPython 3.9以上という動作要件

[PyPIのfoliumページ](https://pypi.org/project/folium/)によると、0.20.0は2025年6月16日の公開で、動作要件はPython 3.9以上、ライセンスはMITです。依存パッケージはbranca、jinja2、numpy、requests、xyzservicesの5つで、pipが一緒に入れます。

```
# 安定版を固定して入れる（pipは候補版を既定で選ばない）
pip install folium==0.20.0

# 1.0.0rc1を試す場合だけ --pre を付ける
pip install --pre folium
```

pipは`--pre`を付けない限り候補版を選ばないため、`pip install folium`だけでも0.20.0が入ります。ただし、要件ファイルにはバージョンを固定して書いておくと、1.0.0の正式版が出た日にCIの結果が変わる事態を防げます。

### 東京駅にマーカーと半径500mの円を置いてHTMLへ保存するコード

最初の地図は、中心座標とズームを決めてマーカーを1つ置くだけです。座標は`[緯度, 経度]`の順で渡します。GeoJSONは経度が先なので、取り違えると地図の外へ点が飛びます。

```
import folium

# 中心座標は [緯度, 経度] の順。zoom_start の既定値は10
m = folium.Map(location=[35.681236, 139.767125], zoom_start=15)

folium.Marker(
    location=[35.681236, 139.767125],
    popup="東京駅",
    tooltip="クリックで詳細",
    icon=folium.Icon(color="red", icon="info-sign"),
).add_to(m)

# radius はメートル単位
folium.Circle([35.681236, 139.767125], radius=500, color="blue", fill=True).add_to(m)

m.save("map_basic.html")
```

Jupyter Notebookなら、最後の行を`m`にするとセルの下に地図が出ます。背景を指定しない場合はOpenStreetMapの標準タイルが使われます。地図をクリックした地点の緯度経度を調べたいときは、`folium.LatLngPopup().add_to(m)`を1行足すと、クリックした場所に座標のポップアップが出ます。

### CSVの地点一覧をpandasで読み、マーカーと経路の線をまとめて描くコード

業務では、地点は1つではなくCSVやデータベースから届きます。この例ではpandasも使うため、先に`pip install pandas`で導入してください。pandasのデータフレームを1行ずつ回してマーカーを置き、同じ座標列を`folium.PolyLine`に渡せば、CSVの行順に地点を結ぶ折れ線になります。道路に沿った経路計算や巡回順の最適化は行いません。

```
import io
import folium
import pandas as pd

# 実務では pd.read_csv("stores.csv") に置き換える
csv = """name,lat,lon
東京駅,35.681236,139.767125
新宿駅,35.690921,139.700258
渋谷駅,35.658034,139.701636
"""
df = pd.read_csv(io.StringIO(csv)).dropna(subset=["lat", "lon"])

m = folium.Map(location=[35.675, 139.73], zoom_start=12)
for row in df.itertuples(index=False):
    folium.Marker([row.lat, row.lon], tooltip=row.name).add_to(m)

coords = df[["lat", "lon"]].values.tolist()
folium.PolyLine(coords, color="green", weight=4).add_to(m)
m.fit_bounds(coords)  # 全地点が収まるズームに合わせる
m.save("map_csv.html")
```

欠損値（NaN）を含む座標を渡すと、Python側の`folium.Marker`の生成時に「Location values cannot contain NaNs.」という`ValueError`が出てHTMLの保存まで進めないため、`dropna`で先に落としておきます。`fit_bounds`を使えば、地点の散らばりに合わせて中心とズームを自分で計算しなくて済みます。マーカーが数千を超えるなら、この`for`文は後述の`FastMarkerCluster`に置き換えてください。

## GeoJSONの塗り分けとGeoPandas連携で業務データを地図に重ねる手順

点だけでなく、エリアごとの数値を色で見せるのがfoliumの主な使い道です。

### style\_functionで売上に応じて色を変えるGeoJsonの塗り分け例

GeoJSONを`folium.GeoJson`に渡し、`style_function`で属性に応じた色を返します。ツールチップには`GeoJsonTooltip`で属性名と表示名を並べます。

```
import folium

geojson = {
    "type": "FeatureCollection",
    "features": [
        {"type": "Feature", "properties": {"name": "エリアA", "sales": 120},
         "geometry": {"type": "Polygon", "coordinates": [[[139.70, 35.66], [139.73, 35.66],
                      [139.73, 35.69], [139.70, 35.69], [139.70, 35.66]]]}},
        {"type": "Feature", "properties": {"name": "エリアB", "sales": 45},
         "geometry": {"type": "Polygon", "coordinates": [[[139.73, 35.66], [139.76, 35.66],
                      [139.76, 35.69], [139.73, 35.69], [139.73, 35.66]]]}},
    ],
}

def style(feature):
    sales = feature["properties"]["sales"]
    return {"fillColor": "#d7301f" if sales >= 100 else "#fdcc8a",
            "color": "#555", "weight": 1, "fillOpacity": 0.6}

m = folium.Map(location=[35.675, 139.73], zoom_start=13)
folium.GeoJson(
    geojson,
    name="売上エリア",
    style_function=style,
    tooltip=folium.GeoJsonTooltip(fields=["name", "sales"], aliases=["エリア", "売上(万円)"]),
).add_to(m)
folium.LayerControl().add_to(m)
m.save("map_geojson.html")
```

GeoJSONの座標は`[経度, 緯度]`の順です。前章のマーカーと逆なので、自前でポリゴンを組むときはここを最初に疑ってください。

### GeoDataFrameを渡すとEPSG:4326へ自動変換される仕様と注意点

[公式のGeoPandas連携ガイド](https://python-visualization.github.io/folium/latest/user%5Fguide/geojson/geopandas%5Fand%5Fgeo%5Finterface.html)のとおり、GeoPandasで読んだGeoDataFrameは`folium.GeoJson`にそのまま渡せます。0.20.0のソースを見ると、`__geo_interface__`と`to_crs`を持つデータは`EPSG:4326`（緯度経度）へ変換してからJSON化する仕様です。平面直角座標系で配られる自治体のデータも、再投影を書かずに重なります。

注意したいのは、CRSが未設定のデータです。変換元が分からないため正しく再投影されません。`gdf.crs`が`None`なら、元データの仕様書で座標系を確かめて`set_crs`で付けてから渡します。座標系の種類と取り込み時の確認項目は[GISデータとは？形式・座標系・取り込み設計を実装目線で解説【2026年8月時点】](/tech/details/16814/)にまとめています。

### ChoroplethとGeoJsonのどちらで塗り分けるかを決める判断基準

`folium.Choropleth`は、pandasのデータフレームとGeoJSONをキーで結合し、凡例付きの段階色を自動で作ります。統計値をそのまま色に落とすだけなら、こちらが短く書けます。

一方、しきい値を業務ルールで決めたい、ツールチップに複数の項目を出したい、クリック時の挙動を変えたいといった要件があるなら、前述の`GeoJson`と`style_function`で組むほうが後から手を入れやすくなります。社内で使い続ける地図は、最初から`GeoJson`で書くと決めておけば迷いません。

## 背景タイルの選び方とAPIキー・Access blocked・Stamenエラーへの対処

foliumの地図は、背景のタイルを外部のサーバーから読み込みます。地図が灰色になる、透かしが入る、エラーで止まるといった不具合の多くはここで起きており、利用規約の問題でもあります。

### CartoDBのタイルに「API KEY REQUIRED」が出る原因とAPIキーの渡し方

foliumは`tiles="CartoDB positron"`のような名前を、依存パッケージxyzservicesのタイル定義から引いています。2026年9月4日公開の2026.9.0で、CartoDBの定義はURLに`key={apikey}`を含む形へ変わりました。同日の[2026.9.1](https://github.com/geopandas/xyzservices/releases/tag/2026.9.1)で例外は警告に緩められ、キーを渡さないと「CartoDB tiles now require an API key.」という警告が出たうえで、キーなしのURLで地図が作られます。

そのURLで読み込まれるタイルには、斜めに「API KEY REQUIRED」と書かれた透かしが入ります。2026年10月27日にキーなしでズーム15のタイルを取得すると、地図の代わりにこの透かしの画像が返りました。[CARTOのBasemaps APIキー取得ページ](https://carto.com/basemaps/apikey/)も、キーをタイルURLに付ければ透かしが消えると案内しています。[公式ガイドのサンプル](https://python-visualization.github.io/folium/latest/user%5Fguide/geojson/geopandas%5Fand%5Fgeo%5Finterface.html)にも`tiles="cartodbpositron"`が残っているため、写して使う場合は書き換えが要ります。

```
import os
import folium
import xyzservices.providers as xyz

# キーはコードに直書きせず環境変数から読む
positron = xyz.CartoDB.Positron(apikey=os.environ["CARTO_API_KEY"])
m = folium.Map(location=[35.681236, 139.767125], zoom_start=13, tiles=positron)
m.save("map_carto.html")
```

出力したHTMLにはキーがURLとして残ります。社外に配るファイルにキーが入る点は、発行元の利用条件と合わせて判断してください。

### tiles=”Stamen Terrain”がValueErrorになる理由とStadia Mapsでの指定方法

2023年以前の解説記事には`tiles="Stamen Terrain"`や`"Stamen Toner"`が載っていますが、folium 0.20.0で実行すると「Custom tiles must have an attribution.」という`ValueError`で止まります。Stamenのタイルは[Stadia Mapsへ移管](https://maps.stamen.com/stadia-partnership/)され、旧URLからの転送は2023年10月31日に止まりました。xyzservicesも[2023.10.1](https://github.com/geopandas/xyzservices/releases/tag/2023.10.1)で`Stamen`の定義を削除したため、foliumは名前をタイル定義として解決できず、URLとみなして出典の指定を求めます。

同じ見た目の地図は、Stadiaの定義名で指定すれば出せます。

```
import folium

# 旧: tiles="Stamen Terrain" は ValueError
m = folium.Map(location=[35.681236, 139.767125], zoom_start=12, tiles="Stadia.StamenTerrain")
m.save("map_stamen.html")
```

[Stadia Mapsの認証ガイド](https://docs.stadiamaps.com/authentication/)では、`localhost`での開発は認証不要、公開するWebサイトはドメイン認証、社内ネットワークのサイトやデスクトップアプリはAPIキーという区分です。2026年10月27日の計測では、`localhost`をRefererに付けたリクエストには画像が返り、Refererを付けないリクエストは401でした。社内ポータルに置くなら、アカウントを作ってAPIキーを発行する前提で考えてください。

### OpenStreetMapのタイルが「Access blocked」になるときの切り分け

既定のOpenStreetMapタイルが、地図の代わりに「Access blocked」と書かれた画像に置き換わることがあります。これはOpenStreetMapの運営団体が、[Tile Usage Policy](https://operations.osmfoundation.org/policies/tiles/)に沿わないアクセスを遮断したときに返す画像です。同ポリシーはWebページからの要求に有効なRefererヘッダを求めており、[2026年3月19日の運用会議の議事録](https://osmfoundation.org/wiki/Operations/Minutes/2026-03-19)には、Referer関連の変更後に遮断の通知を受ける利用者が出ていることが記録されています。

2026年10月27日にcurlで確かめると、ブラウザと同じUser-AgentでRefererを付けない要求には「Access blocked」の画像が返り、`http://127.0.0.1:8000/`や公開ドメインをRefererに付けると通常の地図画像が返りました。folium側で打てる手は次の順です。

- ブラウザのプライバシー拡張やセキュリティソフトがRefererを消していないか確かめる（[OSM WikiのBlocked tiles](https://wiki.openstreetmap.org/wiki/Blocked%5Ftiles)が最初に挙げる原因）
- HTMLをダブルクリックで開かず、`python -m http.server`で配信してから`http://localhost:8000/`で開く
- Webアプリに載せる場合は、ページのReferrer-Policyを`no-referrer`にしていないか確認する
- それでも遮断されるなら、地理院タイルや有償の地図サービスに背景を切り替える

[OSM WikiのReferer解説](https://wiki.openstreetmap.org/wiki/Referer)によると、Leafletは2026年5月に取り込まれた変更で`referrerPolicy`を自動で設定するようになりました。ただし、その変更を含む版はまだ公開されておらず、npmの最新版は2023年5月の1.9.4のままです。foliumが読み込む1.9.3も対象外なので、Wikiが既存のLeaflet向けに案内している`referrerPolicy`を、foliumでは`TileLayer`の引数として渡します。0.20.0で出力したHTMLに`"referrerPolicy": "strict-origin-when-cross-origin"`が入ることを確かめました。

```
import folium

m = folium.Map(location=[35.681236, 139.767125], zoom_start=15, tiles=None)
folium.TileLayer("OpenStreetMap", referrerPolicy="strict-origin-when-cross-origin").add_to(m)
m.save("map_osm.html")
```

なお、ヘッドレスのChromeで確かめた範囲では、`file://`で開いたfoliumのHTMLでも標準タイルは表示されました。ダブルクリックで開いたことだけが原因とは限らないため、上の順に切り分けてください。

### OpenStreetMap標準タイルを商用サービスで使うときの利用規約

既定のOpenStreetMapタイルは無料で使えますが、Tile Usage Policyには遮断の条件以外にも決まりがあります。地図上に著作権表示を出すこと、表示していない範囲のタイルを先読み・一括取得しないこと、ブラウザ以外のアプリではアプリ名が分かるUser-Agentを送ること（ブラウザは既定のUser-Agentのままでよい）、サーバーのHTTPキャッシュヘッダに従うことです。キャッシュヘッダを読めない仕組みなら、各タイルを最低7日キャッシュします。商用サービスや寄付を募るサービスは、提供がいつ止められてもおかしくないと明記されています。OpenStreetMapのデータそのもののライセンスと商用利用の条件は[OpenStreetMap（OSM）とは？使い方・商用利用の条件・APIを公式ポリシーで解説](/tech/details/4744/)で整理しています。

社内の分析レポートなら標準タイルで構いません。顧客に提供するサービスに組み込むなら、有償の地図サービスを選ぶ前提で費用を見積もってください。AWS上で地図・検索・ルート計算まで揃える選択肢は[Amazon Location Serviceとは？料金・APIキーの使い方・日本での制約とGoogle Mapsとの違い【2026年10月】](/tech/details/7221/)で比較しています。

### 国内の業務地図で地理院タイルを背景に使う設定と出典表記の書き方

国内だけを扱う地図なら、国土地理院の地理院タイルも候補になります。[地理院タイル一覧](https://maps.gsi.go.jp/development/ichiran.html)によると、Webサイトやソフトウェアでリアルタイムに表示する用途は、出典を明示すれば申請は要りません。表記は「国土地理院」や「地理院タイル」とし、一覧ページへのリンクを付けます。

```
import folium

m = folium.Map(location=[35.681236, 139.767125], zoom_start=15, tiles=None)
folium.TileLayer(
    tiles="https://cyberjapandata.gsi.go.jp/xyz/pale/{z}/{x}/{y}.png",
    attr='<a href="https://maps.gsi.go.jp/development/ichiran.html">地理院タイル</a>',
    name="地理院タイル（淡色）",
    max_zoom=18,
).add_to(m)
m.save("map_gsi.html")
```

URLで外部のタイルを指定するときは、`attr`を空にできません。foliumは出典がないと、Stamenの節と同じ`ValueError`を出します。淡色地図（pale）は塗り分けの色が背景に埋もれにくく、GeoJSONを重ねる用途と相性がよい地図です。

## 1万点の位置データを描くときのHTMLサイズ比較とプラグインの選び方

点の数が増えると、foliumのHTMLは急に重くなります。描き方でどれだけ差が出るかを数字で示します。

### 1万点でMarkerClusterとFastMarkerClusterの出力サイズを比較

東京周辺に乱数で置いた1万点を、3通りの方法で描いてHTMLのサイズを比べました（folium 0.20.0、2026年10月27日計測）。1.0.0rc1でも差は数バイトでした。表は各方式を単独で追加したHTMLのファイルサイズで、MBは100万バイト換算です。後掲のコードはFastMarkerClusterとHeatMapの両方を含むため、表の約0.41MBとは異なるサイズになります。

| 描き方                      | HTMLサイズ | 仕組み                  |
| ------------------------ | ------- | -------------------- |
| CircleMarkerを1万個         | 約4.97MB | 点ごとにJavaScriptの記述を生成 |
| MarkerCluster＋Markerを1万個 | 約2.29MB | 点ごとの記述＋ズームでまとめる      |
| FastMarkerCluster        | 約0.41MB | 座標を配列で渡しブラウザ側で生成     |

差を生むのは、点ごとにJavaScriptを書き出すかどうかです。`FastMarkerCluster`は座標の配列だけを埋め込み、マーカーはブラウザ側で作ります。ポップアップを点ごとに細かく変える必要がなければ、数千点を超えた時点でこちらへ切り替えてください。

```
import random
import folium
from folium.plugins import FastMarkerCluster, HeatMap

random.seed(0)
points = [[35.6 + random.random() * 0.2, 139.6 + random.random() * 0.3] for _ in range(10000)]

m = folium.Map(location=[35.7, 139.75], zoom_start=11, prefer_canvas=True)
FastMarkerCluster(points, name="店舗（クラスタ）").add_to(m)
HeatMap(points, name="密度", radius=12, show=False).add_to(m)
folium.LayerControl().add_to(m)
m.save("map_many.html")
```

### 密度を伝えたい場面でHeatMapへ切り替える判断とLayerControl

1つずつの地点より「どこに集中しているか」を伝えたいなら、マーカーより`HeatMap`が向いています。上のコードでは`show=False`で最初は非表示にし、右上の`LayerControl`からクラスタ表示と切り替えられるようにしました。

サイズの上限を見積もる目安として、配布するHTMLは数MBに収めると、メール添付や社内ポータルへのアップロードで止まりにくくなります。10万点を超える場合は、対象端末で初期表示時間と操作時の応答を測定し、要求を満たせなければHTMLへの全件埋め込みをやめ、判断章で扱う、タイルやAPIからデータを読み込む作りへ移ってください。

## FlaskとStreamlitにfoliumの地図を埋め込んでWebアプリにする方法

ファイルとして配るだけでなく、Webアプリの画面に地図を出す方法も2通り押さえておきます。

### Flaskでget\_root().render()を返す全画面表示とiframe埋め込み

[公式のFlaskガイド](https://python-visualization.github.io/folium/latest/advanced%5Fguide/flask.html)は、全画面で返す、iframeで埋め込む、ヘッダ・本体・スクリプトに分けて既存テンプレートへ差し込む、の3通りを示しています。先に`pip install flask`でFlaskを導入してください。次のコードを`app.py`として保存し、`flask --app app run`で開発サーバーを起動します。ブラウザで`http://127.0.0.1:5000/`を開くと全画面表示、`http://127.0.0.1:5000/iframe`を開くとiframe表示を確認できます。

```
import folium
from flask import Flask

app = Flask(__name__)

@app.route("/")
def fullscreen():
    m = folium.Map(location=[35.681236, 139.767125], zoom_start=13)
    return m.get_root().render()

@app.route("/iframe")
def iframe():
    m = folium.Map(location=[35.681236, 139.767125], zoom_start=13)
    m.get_root().width = "800px"
    m.get_root().height = "600px"
    return m.get_root()._repr_html_()
```

既存の画面にヘッダやメニューがあるなら、iframe方式がCSSの衝突を起こしにくい選択です。ポップアップに利用者の入力値を出す場合は、HTMLとして解釈されないようエスケープしてから渡してください。

### streamlit-foliumのst\_foliumでクリック地点をPythonに返す例

Streamlitで使うなら、[streamlit-folium](https://github.com/randyzwitch/streamlit-folium)の`st_folium`が定番です。表示するだけでなく、クリックした地点や表示範囲を辞書でPython側へ返します。2026年8月3日公開の[0.27.4](https://pypi.org/project/streamlit-folium/)は動作要件がPython 3.11以上で、folium本体の3.9以上より厳しい点に注意してください。Streamlit自体の書き方は[Streamlitとは？読み方・デメリットとできないこと、使い方とライセンス](/tech/details/3427/)を参照してください。

```
import folium
import streamlit as st
from streamlit_folium import st_folium

m = folium.Map(location=[35.681236, 139.767125], zoom_start=13)
folium.Marker([35.681236, 139.767125], tooltip="東京駅").add_to(m)

# returned_objects を絞ると、地図を動かすたびの再実行を減らせる
data = st_folium(m, height=500, use_container_width=True,
                 returned_objects=["last_clicked", "last_object_clicked"])
st.write(data)
```

0.27.4のソースの説明では、`returned_objects`を省略すると返せる項目をすべて返し、列挙しなかった項目が地図上で変わってもアプリは再実行されません。省略したままだと、拡大・縮小やスクロールのたびにアプリ全体が再実行されます。クリック地点だけ使うなら、上のように受け取る項目を絞ってください。実行にはPython 3.11以上の環境で`pip install streamlit-folium==0.27.4`を実行します。コードを`streamlit_app.py`として保存し、`streamlit run streamlit_app.py`で起動して、端末に表示されるURLをブラウザで開いてください。

## 1.0.0rc1の変更点と0.20系から上げる前に確認する互換性の論点

1.0.0は正式版の前段階にあります。何が変わり、いつ上げるかを整理します。

### 2026年7月26日公開の1.0.0rc1で入ったLayerGroupと3D地球儀

[GitHubのリリースノート（v1.0.0-pre.1）](https://github.com/python-visualization/folium/releases/tag/v1.0.0-pre.1)に並ぶ変更は、大半が不具合修正とドキュメント追加です。機能の追加として目立つのは、LeafletのLayerGroupへの対応、WebGL Earthによる3D地球儀プラグイン、マーカーのアイコン背景への16進カラーコード指定の3つです。

修正のほうでは、整数型のnumpy配列を重みに渡したHeatMapの異常終了、ポップアップ文字列のバックスラッシュの扱い、幅や高さを%で指定したときの表示崩れが直っています。[公式ドキュメント](https://python-visualization.github.io/folium/latest/)の「latest」はすでに1.0.0rc1の内容に切り替わっているため、0.20.0で動かす場合は引数の記述に差がないか確かめてから写してください。

### save()を2回呼ぶとHTMLが重複する0.20系の不具合と回避策

1.0.0rc1で直った不具合のうち、実務で踏みやすいのが`save()`の重複です。同じ地図オブジェクトで`save()`を2回呼ぶと、0.20.0では2回目のHTMLに記述が重なり、2026年10月27日の計測では3,338バイトから3,453バイトへ増えました。1.0.0rc1では2回とも3,341バイトで同じです。

0.20.0のまま運用するなら、地図を作る処理を関数にまとめ、保存のたびに新しい`folium.Map`を作る形にしておけば影響を受けません。本番の更新は1.0.0の正式版を待ち、それまでは要件ファイルで0.20.0に固定する方針を勧めます。

## foliumで足りる地図の用途と業務システムとして作り直すべき条件

最後に、foliumをどこまで使い、どこから別の作りにするかの線を引きます。

### 分析レポートや社内共有ならfoliumで済ませてよい2つの条件

次の2つを満たすなら、foliumで完結させて問題ありません。1つ目は、地図が「見るだけ」で、利用者が地図上で点を追加・編集しないこと。2つ目は、点の数が数千から数万で、データの更新が日次程度の作り直しで間に合うことです。

この範囲なら、Pythonで集計した結果をHTMLにして配るか、Streamlitの画面に載せるだけで用が足ります。地図の専用サーバーやデータベースを新設せずに済むため、その構築・保守作業を省けます。

### 編集・権限・数十万点の更新が要るならfoliumを採用しない判断

反対に、次のいずれかに当たるならfoliumを本体に据えません。現場の担当者が地図上で設備や顧客の位置を登録・修正する。部署や取引先ごとに見える範囲を変える。数十万点以上の位置情報を分単位で更新する。どれも、データを都度HTMLに焼き込むfoliumの方式とは合わない要件です。

この場合は、位置情報をPostGISなどのデータベースで管理し、地図はLeafletやMapLibreをフロントエンドから直接使う構成にします。GISを業務システムへ組み込むときの考え方は[GISとは？地理情報システムの仕組み・種類と業務システムへの組み込み判断](/column/details/16168/)で整理しました。地図を中心にした業務システムを要件定義から作る場合は、一創の[フルスクラッチ開発](https://www.issoh.co.jp/service/system/fullscratch/)でPythonやGoでの設計・開発を承っています。foliumで作った試作の地図を、そのまま要件のたたき台として持ち込んでいただく形でも構いません。

## よくある質問

foliumを使い始めるときに挙がりやすい質問をまとめます。

### foliumとLeafletの違いは何ですか？

LeafletはブラウザでJavaScriptから使う地図ライブラリで、foliumはそのLeafletを呼び出すHTMLをPythonから生成するライブラリです。foliumの0.20.0はLeaflet 1.9.3を読み込みます。Pythonの中で地図を作って配るならfolium、Webアプリのフロントエンドで地図を細かく制御するならLeafletを直接書く、という分担になります。

### foliumの地図をPNG画像で保存できますか？

標準の機能では、保存できるのはHTMLです。内部用のメソッド`_to_png()`はありますが、seleniumとヘッドレスのFirefoxでHTMLを開いて撮影する仕組みで、既定で3秒待ってから撮ります。タイルの読み込みが間に合わないと背景が欠けるため、報告書用の画像が必要なら、待ち時間を延ばすか、静止画に向いた別のライブラリで描くほうが確実です。

### foliumは商用利用できますか？

folium自体はMITライセンスのため、商用のシステムに組み込めます。注意が要るのは背景のタイルです。OpenStreetMapの標準タイルは商用サービスへの提供が保証されておらず、CartoDBは透かしのない背景地図を出すのにAPIキーが要ります（2026年10月27日時点）。地理院タイルは出典の明示で使えます。配布先と規模に合わせて、タイルの利用条件を個別に確かめてください。

### foliumで住所から緯度経度を求められますか？

folium本体にはPythonから住所を座標に変える機能はありません。地図に検索窓を付ける`Geocoder`プラグインはありますが、既定ではOpenStreetMapのNominatimを使い、ソースのコメントでもNominatimの利用ポリシーを守るよう注記されています。大量の住所を変換する用途では、ジオコーディングのAPIで事前に座標を付けてからfoliumに渡してください。

### foliumとPlotlyの地図はどう使い分けますか？

グラフと地図を同じ画面で連動させたい、あるいはDashでダッシュボードを組むなら、Plotlyの地図機能が向いています。GeoJSONの塗り分けやタイルの切り替え、プラグインによるクラスタ表示など、地図そのものを作り込むならfoliumです。Plotlyの基本は[Plotlyとは？Pythonでインタラクティブなグラフを作る基本と使い方](/tech/details/3140/)で確認できます。

## 関連記事

- [Leafletとは？v1.9.4の使い方と地理院タイル表示、2.0移行とMapLibreとの選び分け](/tech/details/18677/)
- [OpenStreetMap（OSM）とは？使い方・商用利用の条件・APIを公式ポリシーで解説](/tech/details/4744/)
- [GISソフトの比較｜無料・商用・クラウドの選定軸と受託開発への切替点](/column/details/16738/)
- [Pandasとは？できること・使い方とPandas 3.0の変更点を解説](/tech/details/3123/)
- [Streamlitとは？読み方・デメリットとできないこと、使い方とライセンス](/tech/details/3427/)

---

出典: [foliumとは：Pythonで地図を作る使い方とタイルのAPIキー・Access blocked対処【2026年版】](<https://www.issoh.co.jp/tech/details/18049/>)（株式会社一創）
