Mapbox APIのご紹介

Mapbox API の「Details」エンドポイントが、パブリックプレビューとして利用可能になりました。 この API により、開発者は単一の API を通じて、世界中の 2 億 5,000 万件以上の場所に関する詳細なメタデータにアクセスできるようになります。AI アプリケーション、ローカル検索、検索体験向けに構築された Places API は、名称、営業時間、属性などの主要なビジネス情報と、各場所が住所、近隣地域、建物とどのように関連しているかといった地理的コンテキストを、単一のデータセットに統合しています。

数百万もの場所に対応する単一のAPI

Mapbox 、世界で最も検索されている目的地に関する重要な情報にアクセスできます。マクドナルド、セブン-イレブン、マリオットといったグローバルブランドから、地元の定番店に至るまで、あらゆる種類の場所を網羅しています。

単一のAPIエンドポイントを通じて、開発者は世界中の2億5,000万件以上のPOI（ポイント・オブ・インタレスト）に関する豊富な情報にアクセスできます。その中には、以下のものが含まれます：

• 店舗の特徴（例：料理の種類、アクセスの良さ、座席数、Wi-Fiの有無など）
• 営業時間および連絡先
• 1時間ごとのアクティビティと人気指標
• 高品質な写真
• 地理的背景（標準化された住所、近隣地域、および建物間の関係）
• 歩行者用入口および車両用到着地点の両方について、正確な座標

Place IDが安定していることで、開発者は、基盤となるデータが現実世界に合わせて更新されても、エンドユーザー向けの体験を構築・維持することができます。これにより、上流のPOIデータベースが更新されるたびに機能が破損したり、絶えず調整が必要になったりすることなく、保存された場所、パーソナライズされたおすすめ、長期的な利用分析など、長期にわたり有効性を維持できる機能を構築することが可能になります。 

AI検索の空間的なニーズに応えるために構築されました

今日では、ユーザーは「近くのコーヒー」といった単純なキーワードを入力する代わりに、「今あまり混んでいない、屋外席があり、犬連れでも利用できるブランチスポットを探して」や「徒歩圏内で、夜遅くまで営業していて、Wi-Fiの接続状態が良い静かなカフェを教えて」といった、会話調の質問をするようになっています。

これらの質問に答えるには、単に店舗名や各POI（ポイント・オブ・インタレスト）の意味的な理解だけでは不十分です。開発者には、詳細な店舗属性、地理的状況、および1日を通じた混雑度に基づいてフィルタリングする機能が必要です。また、これらの場所を地図上で視覚的に表示するためには、正確な地理座標も必要となります。これまで、開発者は複数のプロバイダーから提供される店舗情報、写真、活動データ、建物情報を組み合わせて利用せざるを得ないことがよくありました。 精度や文脈を損なうことなく、これらのデータセットを同期させ続けることは、さらに複雑さを増すことになります。

従来のPOIデータセットは、「このお店はどこにあるのか」といった単純な質問に答えることを目的として設計されていました。しかし、今日のAI検索体験には、それ以上のものが求められています。ユーザーは、場所がどこにあるかという情報だけでなく、その場所の空間的な文脈――つまり、それが何であるか、周囲とどのようにつながっているか、そしてその瞬間にそこで何が起きているか――についても理解する必要があります。ここでは、スムーズで洞察に富んだエンドユーザー体験を構築するために、開発者が取り組むべき課題について詳しく見ていきましょう。 

課題：変化の激しい世界における静的なデータ

従来のデータベースでは、店舗の所在地や公表されている営業時間を把握することはできますが、火曜日の午前9時と金曜日の午後9時を区別せずに、同じ店舗として扱ってしまいます。このデータには、人々の移動パターンといったリアルタイムの文脈が欠けているのです。

Mapbox 、1時間ごとの活動状況（混雑度）を提供しています

ユーザーが混雑を避けたり、人気のスポットを見つけたりできるよう、Mapbox 、場所ごとの混雑状況の傾向を提供しています。Mapbox 、数十億件の匿名化された位置情報信号から得られたテレメトリデータをMapbox 、その場所がいつ閑散としているか、あるいは最も混雑しているかに関する混雑状況のシグナルを提供します。北米および西ヨーロッパの一部の施設で利用可能なMapbox 、飲食、小売、消費者向けサービス、エンターテインメントなどの施設カテゴリについて、1時間ごとおよび曜日ごとの0～100の混雑スコアを提供します。

課題：場所が実際の場所ではなく、単なる点として扱われていること

ほとんどの場所データでは、注目すべき地点を地図上の単一の点として扱っています。その事業所が周囲の建物や近隣地域とどのように結びついているかについては、把握されていません。

Mapbox 、詳細な地理的コンテキストを提供します

Mapbox 、POIを現実世界の環境に直接紐付け、正規化された住所構造、近隣データ、および建物IDを含むDetails APIのレスポンスを提供します。これにより、ユーザーがPOIをタップした際に、Mapbox その建物の正確な敷地範囲を視覚的に強調表示することができます。

課題：「ゴーストプレイス」問題（IDの劣化）

従来の位置情報プロバイダーは、不安定なアップストリームキーに依存しています。データパイプラインが更新されると、POI識別子が頻繁に変更されます。これにより、開発者が気付かないうちに、アプリケーションやユーザーが保存したお気に入り、あるいは下流の分析機能が正常に動作しなくなる可能性があります。

Mapbox は安定したプレイス ID を提供します

上流のパイプライン更新の際に識別子が頻繁に破損してしまう従来のデータセットとは異なり、Mapbox ID は永続的な UUID アンカーとして機能します。これは、変化するデータ構造をエンコードするのではなく参照するため、現実世界のエンティティが恒久的に閉鎖されない限り、保存された場所、顧客分析、アプリリンクの有効性が維持されます。これにより、開発者は、基盤となる現実世界のデータが時間の経過とともに変化しても、引き続き正常に動作するアプリケーションを構築することができます。

課題：最新のAI検索には、位置情報サービスとの連携が必要です

場所を見つけることは、体験の一部に過ぎません。開発者にとっては、ユーザーが次のステップに進めるよう支援するために、地図やルート案内、店舗情報、地理的背景といった情報も必要です。複数のプロバイダーにまたがるこれらのサービスを連携させることは、不必要な複雑さを生み出してしまいます。

Mapbox 、マルチインテントクエリに対するプラットフォームのサポートと検索ボックスの統合を提供します

独立したPOIプロバイダーとは異なり、Places APIは、より広範Mapbox プラットフォームを基盤として構築されています。Placesは、Mapbox 、Geocoding、Boundaries、Navigation間で識別子や地理的コンテキストを共有しているため、開発者は複数のプロバイダーを組み合わせる必要なく、検索からマッピング、ルート案内、分析へとシームレスに移行することができます。

会話型AIのクエリに対応するため、Mapbox APIMapbox Box APIと連携して動作するよう設計されています。Search Box APIのリクエストに新しい「near」パラメータを追加することで、1つのクエリで名称と場所を指定して場所を検索することができます。 たとえば、検索フレーズと位置アンカーを含むクエリ（例：「シカゴのManny’s Deli」）を送信し、Mapbox を取得した後、このIDをPlaces APIのDetailsメソッドで使用して、その場所の完全なメタデータを取得します。 

Mapbox API の使い方を始めましょう

Places APIの「Details」エンドポイントが、本日よりパブリックプレビューとしてご利用いただけるようになりました。最初の1,000件のリクエストは無料でご利用いただけます。本番環境向けのアプリケーションを開発されている場合は、こちらのフォームからご連絡ください。弊社チームより折り返しご連絡いたします。 

Detailsエンドポイントにクエリを送信するには、Search Box APIのレスポンスからmapboxを渡して、完全かつ詳細な場所レコードを取得してください。レスポンススキーマの詳細やその他の情報については、Places APIのドキュメントをご覧ください。

よくある質問

Mapbox API（Detailsエンドポイント）は、Mapbox Box APIとどのように異なるのでしょうか？

これら2つのAPIは、検索体験における異なる段階に対応しています。「Search Box API」は、場所を特定し、Mapbox IDを返すために構築されています。また、ユーザーがすでに名称と場所を知っている場合の一回限りの検索（フォワードエンドポイント）や、「近くのコーヒーショップ」といった、最も近い、あるいは最も一致するPOIをカテゴリ別に検索する場合（カテゴリエンドポイント）にも対応しています。 

Places API の Details エンドポイントは、取得したmapbox を受け取り、事業所の属性、営業時間、活動状況、写真、地理的コンテキストなどを含む、詳細な場所レコードを返します。 

要するに、Search Box API を使って適切な場所を検索し、Places API の Details エンドポイントを利用してその場所に関するすべての詳細情報を取得してください。

時間ごとのアクティビティはどこで確認できますか？

Mapbox 世界中のPOIを網羅していますが、テレメトリデータに基づく1時間ごとの人気スコアなど、当社の最先端の空間レイヤーは現在、北米および西ヨーロッパで順次展開されています。人気のある場所としては、マクドナルド、パネラ、アルディ、プラネット・フィットネス、フェデックス、AMCシアターズなどが挙げられます。

Mapbox API では、写真はどのように扱われるのでしょうか？

Mapbox API の「Details」エンドポイントは、直接 URL を通じて写真を提供するため、開発者は場所カードやインタラクティブな検索結果を即座に充実させることができます。写真のカバー範囲について詳しく知りたい場合や、本番環境での要件についてご相談したい場合は、 こちらのフォームから Mapbox お問い合わせください 。

Mapbox IDが安定している理由は何でしょうか？

上流のパイプライン更新の際に識別子が頻繁に破損してしまう従来のデータセットとは異なり、Mapbox IDは永続的なUUIDアンカーとして機能します。これは、変化するデータ構造をエンコードするのではなく参照するため、現実世界の対象が永久に閉鎖されない限り、保存された場所、顧客分析、およびアプリリンクの有効性が維持されます。