全てのドキュメントchevron-rightヘルプchevron-rightarrow-leftトラブルシューティングchevron-rightSearch API上で日本語検索をする際の考慮

Search API上で日本語検索をする際の考慮

lightning
Public beta for the Search API

Mapbox Search APIはパブリックベータ版です。パブリックベータ版のMapbox Search APIでは、日本国内の場所に対する日本語のクエリのみご利用頂けます。他の言語のクエリで、海外を含めた検索結果をご確認いただくには、Mapbox Geocoding APIをご利用ください。

パブリックベータ期間中にフィードバック まで送信頂いたご意見やご感想は、Search APIの改善に利用させて頂きます。

Mapbox Search API を使って日本国内の場所を日本語で検索する際、様々な要因が検索精度に影響を及ぼします。Search APIをより有効的にお使い頂くためには此方のガイドをお読みください。サポートするスクリプト、住所データのカバー範囲や、検索クエリのフォーマットなどに関して補足しています。

対応文字

Search APIにクエリを行う際、以下の文字をサポートしています:

  • 漢字
  • ひらがな
  • カタカナ
  • ローマ字

同一クエリ内でも、複数種類の文字をご利用可能です。漢字で検索した方が、表音文字(ひらがなやカタカナ)にくらべ、より正確になります。表音文字の場合はより多くの住所情報が必要になります。

住所の丁目/番地/住居番号は、漢字とアラビア数字で入力できます。「丁目」「番地」「住居番号」は、漢字表示やアラビア数字の場合はハイフンでつなげて書くことができます。

日本国内の住所データのカバー範囲

Mapbox Search APIでは、日本全国を網羅するゼンリンの住所データベースを使用しています。データベースの各アドレスには、以下の情報が含まれています:

  • 郵便番号
  • 都道府県名
  • 自治体(「市」、「特別区」、「町」、「行政区」などを含んでいます)
  • 大字(おおあざ。京都の交差点の一部の通りを含む)
  • 丁目(字は通常サポートしていません)
  • 番地(街区符号)
  • 住居番号(地番は含みません)

現在、以下のインデックス化は行っておりません:

  • 建物名
  • 階数
  • 建築サブコード
  • 出入口名や交差点名

日本の住所フォーマット

Search APIのクエリでアドレスをフォーマットする際には、以下の点にご注意ください:

  • ユーザークエリでは、ビル名、フロア名、入口表示、など余分な情報は可能な限り除いてください。Search APIは、余分な情報が無い方が、より正確な結果を取得できます。 住所の順番を入れ替えての検索(例:有明有明東京都江東区)も可能ですが、検索結果の精度が低下する場合があります。
  • Search APIは、番地だけでなく、番号(住居番号)にも対応しています。

全部または一部のみの住所

正式な順番で住所を記載することで、Search APIクエリの成功率が高くなります。例:東京都江東区有明1−6−7

住所の一部だけでも、正確な結果を得られる場合があります。例えば、有明1−6−7〒135-0063 1丁目6番7号のどちらでも上位の検索結果が表示されます。

行政区画

Search APIは、さまざまな行政区画の検索をサポートしていますが、自治体や大字だけで検索する場合は、あいまいな結果になる場合があります。

Search APIは、クエリに最も正確にマッチする行政区画 の取得を試みます。例えば、有明有明1丁目というクエリでは、東京都江東区有明1丁目東京都江東区有明1丁目 6番より上位の結果として表示されます。

京都方式の住所

京都方式の住所で通り名が使用されている場合、Search APIはその通り名を使用して、指定された住所が大字のどの部分にあるかを特定します。Search APIは、通りと通りが交わる交差点のみの住所をサポートしていません。

日本国内の住所検索における既知の問題

  • クエリ内で同じ名前が複数ある場合: Search APIは、クエリ内で同じ単語が複数存在する場合、識別できません。例:横浜 という検索フレーズでは、青森県の横浜町横浜が上位の検索結果になります。これは、「神奈川県の「横浜」は、「市」のみですが、青森県の「横浜町・横浜」は「町」と「大字」の2つのカテゴリに該当するためです。「町」と「大字」という2つフィーチャとのマッチングの方が、「市」のみとのマッチングよりも優先されるためです。この様なケースに関しての対応策は今後も強化していきます。
  • 例外的な住所: データセット内の住所の中には、当社の開発チームが予期できなかった検索結果を表示するものが数多くあります。例:浜7番町という大字は、7番地という街区符号を指していると誤って解釈されます。Mapboxは、このような結果になる住所を特定しており、Search APIの持つクエリに冗長化した情報を使用することで結果の精度を維持しています。上記のようなケースをできるだけ多く特定し、改善を重ねています。
  • 同義語: Search APIでは、地名表記の揺れ(例えば、 ヶ丘が丘)に対してのサポートは一部限られています。

日本国内限定のSearch APIのパブリックベータに関する問題のご報告は、此方までご連絡ください。