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

以下は、フォワード・ジオコーディング（住所を地理座標に変換）とリバース・ジオコーディング（地理座標を住所に変換）の例である：

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

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

一時的なジオコーディングは、順方向または逆方向のジオコーディング検索を即座に取得し、表示することができます。 これは、目的地が地図上のどこにあるかをユーザーに表示するような、短時間のマッピングアプリケーションに便利です。

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

例えば、インブラウザーBI企業は、エンドユーザーの倉庫所在地の地図を繰り返し読み込む必要があるかもしれない。恒久的なジオコーディングがなければ、ユーザーがページをロードするたびに同じ住所を100回以上呼び出さなければならないかもしれない。しかし、恒久的なジオコーディングがあれば、これらの住所をキャッシュし、アプリのパフォーマンスを向上させ、リクエストを節約することができます。

Mapbox グーグルとは異なり、ジオコーディング・データの表示を制限する「ロック・イン」はありません。

顧客は、住所データを分析・視覚化するためにフォワード・ジオコーディングを使用する。例えば、ライドシェア会社は、ユーザーが目的地を（人間が読める住所として）検索し、その住所を（地理座標を使って）地図上で視覚化できるようにするためにフォワードジオコーディングを使用する。

顧客は、車両、荷物、人の物理的住所を特定するためにリバースジオコーディングを使用する。例えば、前述のライドシェア会社は、ユーザーの現在地を地図上に表示するためにリバース・ジオコーディングを使用する。

フォワード・ジオコーディングとリバース・ジオコーディングのその他の使用例としては、以下のようなものがある：

• 天気予報アプリは逆ジオコーディングを使ってユーザーがどの町にいるのかを判断し、ライドシェアアプリはそれを使ってライダーの最寄りの住所を表示する。
• 小売企業は、逆ジオコーディングを使用して、店舗検索で店舗の場所をマッピングする。
• ビジネスインテリジェンスアプリは、不動産分析などのタスクのために、データを空間的に視覚化し、グループ化するために、順方向および逆方向のジオコーディングを使用する。
• Eコマースでは、前方ジオコーディングを使用して、チェックアウトプロセスを簡素化、スピードアップし、配送用の住所を自動入力する。
• 旅行会社はグローバル検索にフォワードジオコーディングを使用し、エンドユーザーが国から地域まで旅行先を発見できるようにしている。
• コンテンツのタグ付けは、エンドユーザーにどこで撮影されたかを見せたい写真アプリのために、逆ジオコーディングによって可能になる。

ジオコーディングAPIを使う際には、さまざまなオプションがある。 (1)結果をすぐに使用するか、将来の使用のために保存するか、(2)座標から作業するか、住所から作業するかを選択できます。

これらのオプションに加え、Geocoding APIは以下の機能を提供する：

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

ジオコーディングがどこでサポートされているかは、カバレッジマップでご確認いただけます。特に、北米、西ヨーロッパ、オーストラリア、日本でのカバー率が高くなっています。しかし、住所カバー範囲は継続的に拡大していますので、頻繁にチェックしてください。

Geocoding APIは40以上の言語をサポートしています。v6では、対応言語を拡大しました：エストニア語、ウクライナ語、イタリア語、ロシア語、マレー語、ベトナム語、ヒンディー語。

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

• 1,000以上のデータソースを統合：私たちのプラットフォームは、幅広いパートナーやソースを活用することで、地理空間データセットをリードしてきました。ソースを組み合わせ、ランク付けすることで、拡大し続けるカバレッジエリアで最も正確な結果を提供します。
• 恒久的なジオコーディング： 私たちは、APIからの結果を永久に保存する能力を提供し、コスト削減とパフォーマンスの可能性を提供し、さらにレポートやジオタグのための新しいユースケースを開きます。
• 修正パイプライン：私たちは、600M MAUのフィードバックと遠隔測定に基づいてデータを更新することに専念する大規模なチームを持っており、毎日700K以上の新しいマップの更新を行っています。このパイプラインは、最新かつ正確な結果を提供するために、データの指名、比較、集約、正規化を行います。
• Mapbox エコシステム：Mapbox 検索は、ナビゲーションおよびマップ製品とシームレスに統合されています。また、Mapbox Boundaries 製品はジオコーディングを補完し、さまざまなパーティションによる集計を可能にします。

ジオコーディングは、一時的なジオコーディングと恒久的なジオコーディングの2つの異なるSKUにわたって、リクエストごとに課金されます。

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

詳しくはhttps://www。mapbox.com/pricing#searchを参照。

v6 の新機能は、大量のジオコーディングを効率的に実行する必要があるお客様に役立つものです：

• v6 の新機能：ユニットレベルのジオコーディング - 特定のアパートメント・ユニットやビジネス・スイートをジオコーディング。
• v6の新機能： 構造化入力 - より良い検索パフォーマンスを得るために、リクエスト内のラベルアドレスコンポーネント。
• v6 の新機能: マッチコード - レスポンスオブジェクトの信頼度スコアにより、精度レベルとキーワードのマッチングをより実感できます。
• v6での改良点： バッチジオコーディング - 1回のリクエストで複数のポイントをジオコーディング。

加えて、カバー範囲、APIの分かりやすさ、使いやすさも向上させた：

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

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

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

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

Confidence Scoreは、クエリとその各コンポーネントが既知の結果とどの程度一致するかを評価します。Confidence Scoreを決定するために、アドレスの各コンポーネントが評価され、真または偽のマッチコードが与えられます。その後、マッチコードの結果が分析され、正確、高、中、低の信頼度スコアが提供されます。

Confidence Score と Match Codes は、ジオコーディング結果を特定のユースケースに合わせて微調整するのに役立ちます。一方、何百万件もの住所レコードを含むデータセットを分析・視覚化する場合は、郵便番号レベルでデータを集計するだけで十分かもしれません。