Appleマップ API
Appleマップは、Appleデバイスに組み込まれた地図サービスです。placesは数値のAppleマップIDから1回で最大50件の場所を取得し、各場所の住所、座標、電話番号、Webサイト、カテゴリ、曜日ごとの営業時間、設備・サービス、写真、評価の詳細を返します。
場所のIDは、DuckDuckGo Mapsの結果のapple_maps_id列、またはAppleマップの共有リンクに含まれるauidから取得できます。Appleマップに表示される評価は提携レビューサイトのものが多いため、各行のrating_sourceにそのサイト名が入ります。1回の呼び出しの料金は、IDが1件でも50件でも同じです。
プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Appleマップの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
場所の詳細places | 数値IDを指定して、1回の呼び出しでApple Mapsの場所を最大50件取得します。各行には住所、座標、電話番号、Webサイト、カテゴリ、曜日別の営業時間、設備・サービス、写真、価格帯、評価とその評価元サイト、代表的なレビュー数件が含まれます。IDはDuckDuckGo Mapsの結果またはApple Mapsのリンクから取得できます。料金はIDが1件でも50件でも1回の呼び出しにつき同じです。 | 1,000リクエストあたり$0.56 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Appleマップの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
places場所の詳細 数値IDを指定して、1回の呼び出しでApple Mapsの場所を最大50件取得します。各行には住所、座標、電話番号、Webサイト、カテゴリ、曜日別の営業時間、設備・サービス、写真、価格帯、評価とその評価元サイト、代表的なレビュー数件が含まれます。IDはDuckDuckGo Mapsの結果またはApple Mapsのリンクから取得できます。料金はIDが1件でも50件でも1回の呼び出しにつき同じです。 | place_ids | language | Sync配信 | — | 1,000リクエストあたり$0.56 | place_id · name · url · category · categories · address · city · state · postal_code · country_code · lat · lng · timezone · phone · website · rating · rating_scale · review_count · rating_source · price · open_state · opening_hours · amenities · image_urls · top_reviews · is_claimed · platform |
Appleマップのplacesのパラメータはそれぞれどういう意味ですか？
数値IDを指定して、1回の呼び出しでApple Mapsの場所を最大50件取得します。各行には住所、座標、電話番号、Webサイト、カテゴリ、曜日別の営業時間、設備・サービス、写真、価格帯、評価とその評価元サイト、代表的なレビュー数件が含まれます。IDはDuckDuckGo Mapsの結果またはApple Mapsのリンクから取得できます。料金はIDが1件でも50件でも1回の呼び出しにつき同じです。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況place_ids必須- 数値形式のApple Maps場所IDを1〜50件のリストで指定します（例：
["12971322601039101590"]）。値はDuckDuckGo Mapsの行のapple_maps_id、またはApple Mapsリンク内のauidから取得します。IDが1件でも50件でも、1回の呼び出しの料金は同じです。数字以外のIDは課金前に拒否されます。Apple Developer Documentation：Place IDによる一意の場所の識別 — Appleの開発者ドキュメントによると、Place IDは存続期間を通じて同じ地点（POI）を識別し続け、その場所の情報を取得するために使用できます。この資料で確認できるのは、Apple Mapsの場所に安定した一意の識別子があることのみです。このAPIの`place_ids`はApple Mapsのリンクに含まれる数字のみのPlace ID（auid）で、MapKitの英数字のPlace IDとは表記が異なり、相互に置き換えることはできません。営業時間、設備、評価のフィールドについては記載されていません。 · 確認日 language任意- 返される場所の詳細情報の言語です（例：
en-US、zh-CN、ja-JP）。enのような2文字のコードも使用できます。デフォルトはen-USです。
Appleマップ 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":"apple_maps","action":"places","params":{"place_ids":"<place_ids>"}}'
Appleマップ APIに関する質問
Appleマップ APIでは何を取得できますか？
platformをapple_mapsに設定します。現在のカタログには場所の詳細が掲載されています。これらのアクション名はそれぞれ異なるAppleマップのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Appleマップのplacesリクエストを開始するには、どの入力を使用しますか？
数値形式のApple Maps場所IDを1〜50件のリストで指定します（例：["12971322601039101590"]）。値はDuckDuckGo Mapsの行のapple_maps_id、またはApple Mapsリンク内のauidから取得します。IDが1件でも50件でも、1回の呼び出しの料金は同じです。数字以外のIDは課金前に拒否されます。params内のplace_idsとして送信してください。
Appleマップのplacesはどのフィールドを返しますか？
宣言されたスキーマにはplace_id、name、category、categoriesが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Appleマップのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。