ジオコーディングには、順方向と逆方向の2種類があります。順方向ジオコーディングは、1600 Pennsylvania Avenue, Washington, D.C. 20500 などの住所を地理座標（つまり、緯度と経度）に変換します。逆ジオコーディングは、(-77.03655, 38.89768) などの座標を前述の住所に変換します。

以下は、順方向ジオコーディング（住所を地理座標に変換）と逆ジオコーディング（地理座標を住所に変換）の例です。

順方向ジオコーディング： 配達アプリは、ドライバーがそこに食べ物を配達できるように、顧客の住所を地図上に配置できる必要があります。そのため、顧客が住所を入力すると、その住所をGeocoder APIに送信し、Geocoder APIはその住所の座標とその他のメタデータを返します。

‍逆ジオコーディング: ある天気アプリの顧客が、エンドユーザーの位置情報に基づいて天気予報を表示する必要があるとします。デバイスから位置の座標を取得すると、顧客はその座標を当社のGeocoder APIに送信し、住所データが返されます。そして、その住所データを使用して、天気予報に正しい都市と地域を表示することができます。

一時的なジオコーディングを使用すると、前方または後方ジオコーディング検索を即座に取得して表示できます。これは、ユーザーに目的地を地図上に示すなど、短期間の地図アプリケーションに役立ちます。

Mapboxはまた、ジオコーディングAPIを介して提供される住所と座標データを永続的に保存できる独自の機能をお客様に提供しています。つまり、お客様はPermanent Geocodingを使用して、同じデータを繰り返しジオコーディングする必要があるシナリオでコストを削減し、パフォーマンスを向上させることができます。

例えば、ブラウザ内のBI企業は、エンドユーザーの倉庫の場所の地図を繰り返し読み込む必要がある場合があります。永続的なジオコーディングがない場合、ユーザーがページを読み込むたびに、同じ住所に対して数百回の呼び出しを行う必要がある場合があります。ただし、永続的なジオコーディングを使用すると、これらのアドレスをキャッシュして、アプリのパフォーマンスを向上させ、リクエストを節約できます。

Mapboxを使用すると、一時的なジオコーディング結果と永続的なジオコーディング結果の両方を、ベンダーに関係なく地図上に表示できます。Googleとは異なり、ジオコーディングデータの表示を当社の地図に制限する「ロックイン」はありません。

顧客は順方向ジオコーディングを使用して、住所データを分析および視覚化します。たとえば、配車会社は順方向ジオコーディングを使用して、ユーザーが目的地（人間が読める住所として）を検索できるようにし、その住所を地図上に（地理座標を使用して）視覚化します。

顧客は、リバースジオコーディングを使用して、車両、荷物、および人の物理的な住所を特定します。たとえば、上記のライドシェア企業は、リバースジオコーディングを使用して、ユーザーの現在地を地図上に表示します。

順方向および逆方向ジオコーディングの追加のユースケースには、以下が含まれます。

• 天気予報アプリは、リバースジオコーディングを使用してユーザーがいる町を特定したり、配車アプリは、リバースジオコーディングを使用して乗客に最も近い住所を表示したりすることがあります。
• 小売企業は、リバースジオコーディングを使用して、店舗ロケーターの店舗の場所をマッピングします。
• ビジネスインテリジェンスアプリは、不動産分析などのタスクのために、順方向および逆方向ジオコーディングを使用して、データを空間的に視覚化およびグループ化します。
• Eコマースは、順ジオコーディングを使用してチェックアウトプロセスを簡素化および高速化し、配送先住所を自動入力します。
• 旅行会社は、エンドユーザーが国から地元の地域まで旅行先を発見できるように、グローバル検索に順方向ジオコーディングを使用しています。
• コンテンツのタグ付けは、撮影場所をエンドユーザーに表示したい写真アプリ向けに、リバースジオコーディングによって有効になります。

Geocoding APIの使用にはいくつかのオプションがあります。(1) 結果をすぐに使用するか、将来の使用のために保存するか、(2) 座標から作業するか、住所から作業するかを選択できます。

これらのオプションに加えて、Geocoding APIは次の機能を提供します。

• v6で改善されました：コンテキストオブジェクト - 地理座標に加えて、近隣、郵便番号、地域、国など、住所に関する階層データを取得します。 階層内の各場所にはIDが添付されており、後続の検索が可能です。
• オートコンプリート - タイプアヘッド機能を実装し、エンドユーザーが入力する際に住所の候補を提示します。
• 近接バイアス - デバイスの位置やIPアドレスなど、特定の場所の周辺のジオコーディング結果を優先します。
• v6の新機能: 構造化入力 - リクエスト内のラベルアドレスコンポーネントにより、検索パフォーマンスが向上します。
• v6で改善されました：バッチジオコーディング - 単一のリクエストで複数のポイントをジオコーディングします。   
• 交差点検索 - 正確な住所がなくても、2つの道路が交差する地点を検索
• v6の新機能: スマートアドレスマッチ - レスポンスオブジェクト内の信頼度スコアにより、精度レベルとキーワードマッチングをより正確に把握できます。
• v6で改善されました：多言語サポート - ジオコーディング検索が40以上の言語でサポートされるようになりました。

ジオコーディングがサポートされている地域については、カバレッジマップをご確認ください。特に、北米、西ヨーロッパ、オーストラリア、日本で強力なカバレッジを提供しています。住所のカバレッジは継続的に拡大しているため、頻繁に確認してください。

ジオコーディングAPIは40以上の言語をサポートしています：言語カバレッジ。v6では、エストニア語、ウクライナ語、イタリア語、ロシア語、マレー語、ベトナム語、ヒンディー語をサポート対象に追加しました。

MapboxのジオコーディングAPIには、他のソリューションに比べて多くの利点があります。

• 数千のデータソースの統合: 当社のプラットフォームは、幅広いパートナーとソースを活用して、業界をリードする地理空間データセットを作成しました。ソースを組み合わせてランク付けし、拡大し続けるカバレッジエリア全体で最も正確な結果を提供します。
• 永続的なジオコーディング: Mapboxは、APIからの結果を永続的に保存する機能を提供し、コスト削減とパフォーマンスの可能性を実現し、レポートとジオタグの新しいユースケースを開きます。
• 修正パイプライン: 当社には、6億人のMAUからのフィードバックとテレメトリに基づいてデータを更新することに専念する大規模なチームがあり、毎日70万件を超える新しい地図の更新を行っています。このパイプラインは、データをノミネート、比較、集約、および正準化して、最新かつ正確な結果を提供します。
• Mapbox Ecosystem: Mapbox Searchは、当社のナビゲーションおよび地図製品とシームレスに統合されています。また、Mapbox Boundaries製品は、ジオコーディングを補完し、さまざまなパーティションによる集計を可能にします。

ジオコーディングは、一時的なジオコーディングと永続的なジオコーディングという2つの異なるSKUで、リクエストごとに課金されます。

• Temporary Geocoding APIの料金は、1,000リクエストあたり0.75ドル〜0.45ドルで、大量のリクエストの場合はさらに割引が適用されます。
• Permanent Geocoding API の料金は、1,000 リクエストあたり 5 ～ 4 ドル (CPM) で、大量のリクエストの場合はさらに割引が適用されます。

詳細については、https://www.mapbox.com/pricing#searchをご覧ください。

v6の新機能は、大量のジオコーディングを効率的に実行する必要がある顧客にメリットをもたらします。

• v6の新機能: ユニットレベルのジオコーディング - 特定のアパートのユニットやビジネススイートをジオコードし、利用可能な場合は固有の座標を取得する機能も含まれます。
• v6の新機能: 構造化入力 - リクエスト内のラベルアドレスコンポーネントにより、検索パフォーマンスが向上します。
• v6の新機能: マッチコード - レスポンスオブジェクトの信頼性スコアにより、精度レベルとキーワードマッチングの認識が向上します。
• v6で改善: バッチジオコーディング - 1回の要求で複数のポイントをジオコーディングします。

さらに、カバレッジ、APIの理解度、およびユーザビリティをアップグレードしました。

• v6の新機能: 日本のアドレス - 業界をリードするカバレッジで日本のアドレスをジオコード。3,400万件の新しいアドレスが追加されました。
• v6で改善: コンテキストオブジェクト - 近隣、郵便番号、地域、国など、住所に関する階層データを取得します。
• v6で改善: 多言語サポート - 40以上の言語でサポートされているジオコーディング検索。

構造化入力は、住所データを事前に解析できるオプションのパラメーターです。1600%20Pennsylvania%20Avenue%20Washington,%20D.C.%2020500のような文字列をクエリする代わりに、num=1600&street=Pennsylvania%20Avenue&city=Washington,%20D.C.&postcode=20500をクエリできます。これにより、クエリの理解度が高まり、可能な限り迅速に正しい結果が得られる可能性が高まります。構造化クエリは最大20%高速に処理されます。

構造化入力の詳細については、ドキュメントをお読みください。

Smart Address Matchは、信頼度スコアとマッチコードで構成されています。

信頼度スコアは、クエリとその個々のコンポーネントが既知の結果とどれだけ一致するかを評価します。信頼度スコアを決定するために、アドレスの各コンポーネントが評価され、trueまたはfalseの一致コードが与えられます。一致コードの結果が分析され、正確、高、中、または低の信頼度範囲の全体的な信頼度スコアが提供されます。

信頼度スコアと一致コードは、特定のユースケースに合わせてジオコーディングの結果を微調整するのに役立ちます。たとえば、配送業務を行っている場合は、一致コードを使用して、最も正確な結果のみを使用するようにすることができます。一方、数百万件のアドレスレコードを含むデータセットを分析および視覚化している場合は、郵便番号レベルでデータを集計するだけで十分な場合があります。