はじめに

本記事から、foliumのチュートリアルを動かしていきます。

foliumとは

foliumは、Pythonで地図を可視化するためのライブラリであり、Leaflet.jsというJavaScriptライブラリを使用しています。
foliumを使用すると、Pythonプログラムから簡単に地図を作成し、Webブラウザ上で表示することができます。

foliumは、Pythonのデータ分析ライブラリであるPandasと組み合わせて使用することができ、地理情報を含むデータを解析する際に便利です。

Quickstart

こちらのチュートリアルを進めます。

準備

1. Pycharmのインストール

以下のリンク等を参考に、PyCharmをインストールします。
(Intellijなどの使用経験があり)JetBrainsのアカウントをすでに持っている場合は、Professional版でも問題ありません。

2. 新規プロジェクトの作成

PyCharmを開き、メニューから「File」->「New Project」を選択します。
その後プロジェクトの名前と保存先を指定し、「Create」ボタンをクリックします。

3. foliumライブラリのインストール

プロジェクトが作成されたら、foliumライブラリをインストールする必要があります。
PyCharmのTerminalを開き、「pip install folium」と入力して、foliumライブラリをインストールします。

基本的な使い方

地図の表示

foliumを使ってベースマップを作成するためには、folium.Map()を使用します。

この関数には、地図の中心点を示す緯度と経度のリストlocationを引数として渡すことができます。
また、zoom_startパラメータでは、地図の表示範囲指定を行うことができます。

例として北海道札幌市の中心部にある「時計台」という観光名所を表示してみます。
新宿駅の緯度は43.0625587、経度は141.3535504です。

sample1.py

import folium

# 地図の中心となる緯度経度を指定する
sapporo_center = [43.0625587, 141.354376]

# 地図を作成し、札幌市全域を表示するためのズームレベルを設定
folium_map = folium.Map(location=sapporo_center, zoom_start=12)

# 地図をHTMLファイルとして保存する
folium_map.save('map-sample1.html')

実行した後に得られたhtmlファイルを表示してみると、以下のマップが得られます。

タイルの変更

foliumにはデフォルトでOpenStreetMap以外にもStamen Terrain、Stamen Toner、Mapbox Bright、Mapbox Control Roomなどのタイルが用意されています。
foliumのtilesパラメーターを使用して指定することができます。

それぞれの特徴を以下に述べます。

OpenStreetMap : デフォルトのタイル。利用者自身が地図の編集やデータの追加を行うことができるため、情報量や精度が他のタイルと比べて高いことが特徴。
Stamen Terrain：地形の詳細を表示するためのタイル。標高線や山脈、河川などが視覚的に強調されている。
Stamen Toner：黒と白を基調としたタイル。道路や建物、地物名などがシンプルに表示され、グラフィカルな背景や地形のディテールは省略されている。
Mapbox Bright：明るい色調を基調としたタイル。道路や建物、地物名などが細かく表示されており、街中の地図として使用されることが多い。

今回の北海道札幌市の例では、tilesパラメーターで"Stamen Terrain"を指定します。

sample2.py

import folium

# 地図の中心となる緯度経度を指定する
sapporo_center = [43.0625587, 141.354376]

# 地図を作成し、札幌市全域を表示するためのズームレベルを設定
# 引数tilesには"Stamen Terrain"を指定
folium_map = folium.Map(location=sapporo_center, zoom_start=12, tiles="Stamen Terrain")

# 地図をHTMLファイルとして保存する
folium_map.save("map-sample2.html")

実行した後に得られたhtmlファイルを表示してみると、以下のマップが得られます。
なんか自然が多くなった気がします。

ここでは扱いませんが、独自のタイルセットを指定することもできます。

folium.Map(location=[45.5236, -122.6750],
           tiles='URL',
           API_key='your.API.key')

マーカーのプロット

folium.Marker()関数を使うと、マーカーを地図上にプロットすることができます。

sample3.py

import folium

# 地図の中心となる緯度経度を指定
sapporo_center = [43.0625587, 141.354376]

# 地図を作成
folium_map = folium.Map(location=sapporo_center, zoom_start=12)

# マーカープロット
folium.Marker(location=[43.0625587, 141.354376]).add_to(folium_map)

# 地図をHTMLファイルとして保存
folium_map.save('map-sample3.html')

実行した後に得られたhtmlファイルを表示してみると、以下のマップが得られます。

ポップアップ(マーカーをクリックしたときに表示される)やツールチップ（マーカーにカーソルを合わせたときに表示される）を指定することもできます。
今回は札幌ドームのマーカーを追加します。

sample4.py

import folium

# 地図の中心となる緯度経度を指定
sapporo_center = [43.0625587, 141.354376]

# 地図を作成
folium_map = folium.Map(location=sapporo_center, zoom_start=12)

# ツールチップを指定
tooltip = "Click me!"

# マーカープロット（時計台）
folium.Marker(
    location=[43.0625587, 141.354376],
    popup="<i>時計台</i>",  # ポップアップを指定
    tooltip=tooltip  # ツールチップを指定
).add_to(folium_map)

# マーカープロット（札幌ドーム）
folium.Marker(
    location=[43.0177717, 141.4087122],
    popup="<i>札幌ドーム</i>",  # ポップアップを指定
    tooltip=tooltip  # ツールチップを指定
).add_to(folium_map)

# 地図をHTMLファイルとして保存
folium_map.save('map-sample4.html')