valhalla-route

name	valhalla-route
description	Valhalla ルーティング API を使って出発地→目的地のルートを GeoJSON LineString に変換し MapLibre で可視化する。「AからBまで歩く/車で行く/自転車で行く」ルート表示リクエストに使う。

Valhalla Route スキル

環境制約

• Valhalla エンドポイント: https://valhalla.yuiseki.net/route（POST, JSON）全世界対応 (planet データ)
• Nominatim: https://nominatim.yuiseki.net/search.php?q=<地名>&format=json（座標取得）全世界対応
• ビルド: make fast-build のみ（make build 禁止）

ワークフロー（4ステップ）

STEP 1: 出発地・目的地の座標取得

legacy-work-spec.json の routing.from / routing.to から地名を読む。座標取得は Python スクリプトで行う（日本語URL エンコーディングの問題を回避):

python3 << 'EOF'
import urllib.request, urllib.parse, json

def geocode(place):
    url = "https://nominatim.yuiseki.net/search.php?" + urllib.parse.urlencode({
        "q": place, "format": "json", "limit": "1"
    })
    req = urllib.request.Request(url, headers={"User-Agent": "NereidMap/1.0"})
    with urllib.request.urlopen(req, timeout=10) as r:
        results = json.loads(r.read())
    if not results:
        raise ValueError(f"Nominatim: no results for '{place}'")
    return float(results[0]["lat"]), float(results[0]["lon"])

from_lat, from_lon = geocode("東京駅")
to_lat, to_lon   = geocode("上野駅")
print(f"FROM: {from_lat},{from_lon}")
print(f"TO:   {to_lat},{to_lon}")
EOF

コスティング選択:

• 徒歩・歩く → pedestrian
• 車・自動車 → auto
• 自転車 → bicycle

STEP 2: Valhalla API 呼び出し

curl -s https://valhalla.yuiseki.net/route \
  -H "Content-Type: application/json" \
  -d "{
    \"locations\": [
      {\"lat\": $FROM_LAT, \"lon\": $FROM_LON},
      {\"lat\": $TO_LAT, \"lon\": $TO_LON}
    ],
    \"costing\": \"pedestrian\",
    \"units\": \"meters\"
  }" -o /tmp/valhalla_response.json

# 確認
python3 -c "
import json
d = json.load(open('/tmp/valhalla_response.json'))
s = d['trip']['summary']
print(f'距離: {s[\"length\"]*1000:.0f}m, 所要時間: {s[\"time\"]:.0f}秒')
"

STEP 3: shape デコード → GeoJSON 変換

Valhalla は precision=6 の encoded polyline を返す。Python で GeoJSON LineString に変換:

python3 -c "
import json

def decode_polyline6(encoded):
    coords = []
    index = lat = lng = 0
    while index < len(encoded):
        for is_lat in (True, False):
            shift = result = 0
            while True:
                b = ord(encoded[index]) - 63
                index += 1
                result |= (b & 0x1f) << shift
                shift += 5
                if b < 0x20: break
            delta = ~(result >> 1) if (result & 1) else (result >> 1)
            if is_lat: lat += delta
            else: lng += delta
        coords.append([lng / 1e6, lat / 1e6])
    return coords

d = json.load(open('/tmp/valhalla_response.json'))
shape = d['trip']['legs'][0]['shape']
coords = decode_polyline6(shape)
summary = d['trip']['summary']

geojson = {
    'type': 'FeatureCollection',
    'features': [{
        'type': 'Feature',
        'geometry': {'type': 'LineString', 'coordinates': coords},
        'properties': {
            'distance_m': round(summary['length'] * 1000),
            'time_s': round(summary['time']),
            'costing': 'pedestrian'
        }
    }]
}
import os
os.makedirs('public/layers', exist_ok=True)
with open('public/layers/route.geojson', 'w') as f:
    json.dump(geojson, f, ensure_ascii=False)
print(f'Route saved: {len(coords)} points, {round(summary[\"length\"]*1000)}m')
"

STEP 4: config.json 更新 + ビルド

# ルートの中間点を中心座標として使用
python3 -c "
import json
gj = json.load(open('public/layers/route.geojson'))
coords = gj['features'][0]['geometry']['coordinates']
mid = coords[len(coords)//2]
props = gj['features'][0]['properties']
dist_km = props['distance_m'] / 1000

config = {
    'title': f'ルート ({dist_km:.1f}km)',
    'initialView': {'longitude': mid[0], 'latitude': mid[1], 'zoom': 14},
    'showPopupOnClick': False,
    'layers': [
        {
            'id': 'route',
            'name': 'ルート',
            'file': './layers/route.geojson',
            'emoji': '🚶',
            'color': '#2196f3',
            'outlineColor': '#0d47a1',
            'showMarker': False
        }
    ]
}
import os
os.makedirs('public/layers', exist_ok=True)
with open('public/layers/config.json', 'w') as f:
    json.dump(config, f, ensure_ascii=False, indent=2)
print('config.json saved')
"

make fast-build

コスティング別絵文字・カラー

移動手段	costing	emoji	color	outlineColor
徒歩	pedestrian	🚶	#bbdefb	#0d47a1
自転車	bicycle	🚴	#c8e6c9	#1b5e20
車	auto	🚗	#ffccbc	#bf360c

エラーハンドリング

1. Nominatim 結果が 0 件: クエリを英語名に変更（例:「東京駅」→「Tokyo Station」）
2. Valhalla が空レスポンス: echo $? でステータス確認、座標の lat/lon が逆でないか確認
3. make fast-build エラー: mkdir -p public/layers を実行してから再試行