プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Bingマップの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | 地図の中心付近でkeywordに一致するビジネスをBing Mapsで検索します。BingのビジネスID、住所、座標、電話番号、Webサイト、カテゴリ、営業状況、YelpやTripAdvisorなどのサイトによる評価とレビュー数を取得できます。1ページあたり最大30件です。 | 1,000リクエストあたり$0.56 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Bingマップの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 地図の中心付近で | keyword | language, latitude, longitude, page | Sync配信 | カタログ値：defaultLimit=20、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | rank · place_id · name · url · category · address · lat · lng · phone · website · rating · rating_scale · review_count · rating_source · open_state · hours_text · image_url · platform |
Bingマップのsearchのパラメータはそれぞれどういう意味ですか？
地図の中心付近でkeywordに一致するビジネスをBing Mapsで検索します。BingのビジネスID、住所、座標、電話番号、Webサイト、カテゴリ、営業状況、YelpやTripAdvisorなどのサイトによる評価とレビュー数を取得できます。1ページあたり最大30件です。
keyword必須- 地図上で探す対象です。ビジネス名やカテゴリを指定します（例：
coffee、pizza）。 language任意- 返される掲載情報の言語を指定する2文字の言語コードです（例：
en、de）。 latitude任意- 地図の中心の緯度（-90〜90）です。
longitudeと一緒に指定します。中心を指定しない場合はBingが場所を選ぶため、目的の都市にならないことがあります。Microsoft Learn：Bing Maps Local Searchによる指定地点周辺のビジネス検索 — Microsoftのドキュメントによると、Bing Maps Local Searchはクエリに加えて、ユーザーの位置、境界ボックス、または円を受け取り、その周辺のビジネスエンティティを返します。この公式インターフェースは無料アカウントでは提供が終了しており、対象は米国のビジネスのみです。この資料で確認できるのは、Bing Mapsが地図上の位置からビジネスを検索できることのみです。このAPIの`latitude`と`longitude`はEveryInfraが定義した地図の中心点で、この公式インターフェースとは別のものであり、その地域制限は適用されません。 · 確認日 longitude任意- 地図の中心の経度（-180〜180）です。
latitudeと一緒に指定します。 page任意- 返す掲載情報のページ番号です。1から始まり、1ページあたり
limit件のビジネスが含まれます（最大20ページ）。
Bingマップ APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"bing_maps","action":"search","params":{"keyword":"<keyword>"}}'
Bingマップ APIに関する質問
Bingマップ APIでは何を取得できますか？
platformをbing_mapsに設定します。現在のカタログには検索が掲載されています。これらのアクション名はそれぞれ異なるBingマップのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Bingマップのsearchリクエストを開始するには、どの入力を使用しますか？
地図上で探す対象です。ビジネス名やカテゴリを指定します（例：coffee、pizza）。params内のkeywordとして送信してください。
Bingマップのsearchはどのフィールドを返しますか？
宣言されたスキーマにはrank、place_id、name、categoryが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Bingマップのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。