歴史地図アプリに日本語検索を実装: GeoJSONデータの効率的な翻訳手法

Sun, 15 Feb 2026 19:00:00 +0900

はじめに

歴史的国境を可視化する地図アプリを作っていたら、「日本語で国名検索ができない」という問題に直面した。外部のGeoJSONデータは英語のみで、日本語プロパティがない。

そこで、Gemini APIを使って効率的にデータを翻訳し、日本語検索を実装した手法を紹介する。

問題: 外部GeoJSONデータには日本語がない

使用したデータソース:

現代国境: Natural Earth (約200カ国)
歴史的国境: aourednik/historical-basemaps (18ファイル、紀元前2000年〜1920年)

{
  "type": "Feature",
  "properties": {
    "NAME": "France",
    "NAME_JA": null  // ← 日本語プロパティがない!
  },
  "geometry": { ... }
}

このままでは「フランス」で検索できない。

解決策: 翻訳キャッシュを使った効率的なデータ拡張

アプローチ1: 愚直な方法 (非効率)

各ファイルごとに全データをLLMに投げる:

// ❌ 非効率: 同じ国名を何度も翻訳
for (const file of geoJsonFiles) {
  const data = await fetch(file);
  const translated = await translateAll(data); // Franceを18回翻訳...
  await save(translated);
}

問題点:

同じ国名が複数ファイルに登場 → 重複翻訳
トークン消費が膨大
処理時間が長い

アプローチ2: 翻訳キャッシュ方式 (効率的) ✅

全ファイル共通の翻訳キャッシュを使い回す:

// ✅ 効率的: 一度翻訳した国名は二度と翻訳しない
const translationCache = {}; // { "France": "フランス", ... }

for (const file of geoJsonFiles) {
  const data = await fetch(file);
  
  // 未翻訳の国名のみ抽出
  const newNames = extractUntranslatedNames(data, translationCache);
  
  // 新規の国名だけ翻訳
  if (newNames.length > 0) {
    const translations = await translate(newNames);
    Object.assign(translationCache, translations);
  }
  
  // キャッシュを使って適用
  applyTranslations(data, translationCache);
  await save(data);
}

実装: Node.jsスクリプト

完全なコード

この手法をNode.jsスクリプトとして実装した。Gemini 2.5 Flash Liteを使用している。この程度の翻訳ならこれで十分。

Gemini API on 怠惰技術ブログ