公共交通機関の検索 - API V8

公共交通機関の検索 API V8 は、指定されたエリア内にトランジットステーションを提供します。

/stations 応答は、ステーションに関する関連情報を含む一連のステーションで構成されています。 address およびなどの追加のプロパティ transportは、任意で要求できます。

ユースケース

公共交通機関検索 API V8 の一般的な用途は次のとおりです。

• 特定の場所から特定の距離にあるステーションの数を取得します
• 名前、識別子、場所、タイプなど、ステーション固有の情報を取得します
• 特定のステーションにサービスを提供するトランスポートラインを定義します

クエリーのタイプ

公共交通機関の検索 API V8 には、次の 3 種類のクエリがあります。

• ID で検索します
• 場所で検索します
• 名前と場所で検索します

ID でステーションを照会します

このクエリは、ステーションの識別子がわかっていて、その情報を要求する場合に役立ちます。 ID でステーションを照会する場合 stations 、応答のエレメントには選択したステーションのステーションのみが含まれます。

場所でステーションを検索します

このクエリは、選択した場所で利用できるトランジットステーションを確認する場合に役立ちます。 このクエリは、円形のエリアにあるステーションを返します。 領域の中心とサイズは、選択した場所と半径でそれぞれ設定されます。

maxPlaces このパラメータを使用して、応答のステーション数を制限できます。

名前と場所でステーションを照会します

このクエリは、選択した場所にあるステーションのうち、ステーションの数が多すぎるステーションを検索する場合に役立ちます。 このシナリオは、多くの異なるトランジットモードを使用する大規模なトランジットハブで一般的に使用され、特定のステーションを検索することは困難な場合があります。 必須 name パラメータは、検索するステーション名または名前の一部です。 スペースで区切られた 1 つ以上の単語で構成されます。 nameは 、オプションの method パラメータと組み合わせて、デフォルトで一致するか fuzzy（名前部品など）、またはstrict （正確な名前）を指定します。 maxPlaces このパラメータを使用して、応答のステーション数を制限できます。

前述のすべてのクエリーは return 、応答で転送情報を返すことができるパラメータを受け入れます。

公共交通機関の検索 API V8 の使用方法の詳細については、 「リクエストの送信方法 」を参照して、次のいずれかの例を参照してください。

• ID でステーションを検索します
• 場所でステーションを検索します
• 名前と場所でステーションを検索します。