---
name: reference-map-provider-5alt-paths-2026-05-24
description: WIC map γ 切替で確立した OpenFreeMap (現使用) + 5 ALT provider migration paths. MapLibre GL vendor-neutral で 1 URL 変更 switch 可能. OpenFreeMap shutdown 時の defensive plan.
metadata: 
  node_type: memory
  type: reference
  originSessionId: e3178227-7e7e-4f04-bfe4-5fda3883d4ba
---

★★★ 2026-05-24 確立. **WIC map provider 5 ALT migration paths**. WorldGlobe.astro 内 comment block + 本 memory 両方に文書化.

### Current: OpenFreeMap (γ path)
- URL: `https://tiles.openfreemap.org/styles/dark`
- Provider: Zsolt Erő (Hungarian dev), donations + GitHub Sponsors
- Cost: ¥0 + no API key
- Source code: `fc0web/openfreemap` (forked backup, MIT, 4 MB)
- Data: ~80-100 GB world PMTiles (operator self-hosted)
- Update: weekly (every Wednesday for planet)
- License: MIT (source) + ODbL (OSM data, attribution required, already in WIC)
- Risk: low-medium (個人 1 人 dev + donations, no guarantee)

### ALT 1: Protomaps Cloud
- URL: `https://api.protomaps.com/tiles/v4.json?key=YOUR_KEY`
- Cost: free 100K req/月, +$0.50/1M after
- Sign up: https://protomaps.com → dashboard
- Required: API key
- Implementation:
  ```typescript
  import * as pmtiles from 'pmtiles';
  import layers from 'protomaps-themes-base';
  const protocol = new pmtiles.Protocol();
  maplibregl.addProtocol('pmtiles', protocol.tile);
  style: {
    version: 8,
    glyphs: 'https://protomaps.github.io/basemaps-assets/fonts/{fontstack}/{range}.pbf',
    sprite: 'https://protomaps.github.io/basemaps-assets/sprites/v4/dark',
    sources: { protomaps: { type: 'vector', url: 'https://api.protomaps.com/tiles/v4.json?key=YOUR_KEY' } },
    layers: layers('protomaps', 'dark'),
  }
  ```
- npm: `pmtiles ^4.4.1` + `protomaps-themes-base ^4.5.0` (WIC 既 install)

### ALT 2: 自前 R2 host (Cloudflare)
- Cost: ~$1.50/月 (100 GB storage, R2 free egress to CF Pages)
- Required: Download PMTiles + R2 upload + URL config
- PMTiles source: https://github.com/protomaps/basemaps (releases) or build from planet.osm.pbf
- Implementation:
  ```typescript
  url: 'pmtiles://https://your-r2-bucket.r2.dev/world.pmtiles'
  ```

### ALT 3: Stadia Maps free tier
- URL: `https://tiles.stadiamaps.com/styles/alidade_smooth_dark.json?api_key=YOUR_KEY`
- Cost: free for 個人 / 開発用 (commercial で要有料)
- Sign up: https://stadiamaps.com
- Required: API key
- Implementation: style URL 1 行差替

### ALT 4: MapTiler free tier
- URL: `https://api.maptiler.com/maps/streets-v2-dark/style.json?key=YOUR_KEY`
- Cost: free 100K req/月
- Sign up: https://maptiler.com
- Required: API key
- Implementation: style URL 1 行差替

### ALT 5: CARTO raster (旧 path, fallback only)
- URL: `https://{a-c}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}.png`
- Cost: ¥0 permanent free
- Required: none
- 限界: raster only, 市町村 detail 弱い, WIC γ path 前の状態
- Implementation:
  ```typescript
  style: {
    version: 8,
    sources: { 'osm-dark': { type: 'raster', tiles: ['https://{a-c}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}.png'], tileSize: 256, attribution: '© OpenStreetMap + CARTO' } },
    layers: [{ id: 'osm-dark-layer', type: 'raster', source: 'osm-dark' }],
  }
  ```

### Switch protocol (何 ALT への移行も 5-30 分作業)

1. WIC repo: `C:\Users\user\world-investment-center\src\components\WorldGlobe.astro` 編集
2. line 264 周辺 `style:` 部分を ALT 該当 code に差替
3. ALT 1-4 で API key 必要時: 環境変数 or hardcoded constant (個人運営 OK)
4. `npm run build` → `wrangler pages deploy dist --project-name world-investment-center`
5. Live URL `world-investment-center.pages.dev/` で hard refresh → detail level 確認

### Defensive backup state
- ✅ **fc0web/openfreemap fork**: source code 永久保存 (元 repo 削除されても fork 独立存続)
- ✅ **WorldGlobe.astro 内 5 ALT migration path documented** (in-source 永久 reference)
- ✅ **pmtiles + protomaps-themes-base npm installed** (Protomaps switch path 即時 ready)
- ✅ **MapLibre GL vendor-neutral library** (source 切替 1 URL 変更で OK)

### honest scope flags
- OpenFreeMap dependency = acceptable risk for 個人運営 sustainable
- Shutdown 時の migration cost ≈ 30 分 + 最大 $1.50/月 (R2 path 採用時)
- 全 free tile provider 同時 shutdown は非現実的 (OSM data 自体は ODbL で permanent, raw data から build 可能)
- 自前 R2 host が最終 fallback (常時利用可能 + コスト最小)

### Related memory
- [[project-wic-complete-deploy-paper157-2026-05-24]] — γ path 実装 + fork backup 詳細
- [[feedback-wwd-strategic-moats-against-bigtech]] — 「大手絶対やらない」 原則