SWAT API の概要
SWAT は 3 つの API 製品を提供しています。
- Stateless API: VRP ソルバー技術へのアクセスを提供します。最大限の柔軟性を提供しますが、よ り複雑な統合が必要です。この API を使用する場合、SWAT システムは顧客データを保存または保持しません。
- Integration API: 顧客の注文、フリート情報、顧客マスターデータなど、SWAT システム内のデータを管理します。これは、SWAT 製品と対話し、TMS、OMS、WMS などのシステムと統合するための主要な方法です。このステートフル API を使用すると、Stateless API の複雑さなしに、カスタムの最適化パイプラインを実行できます。
- Routing API: 拡張 OSRM 標準プロトコルに従い、動的な予測交通量をサポートするルートを生成します。
すべての API は独立して使用できます。
SWAT API は、最先端の技術を活用して、ルート生成、ルート最適化、および積載最適化のための高度な機能を提供します。API は 3 つのカテゴリに分類されます。
- ルートと時間/距離マトリックスの生成 (Routing API と呼ばれます)
- インテグレーターがウェイポイント、車両、積荷、およびすべての静的データを管理するルート最適化 (Optimization API と呼ばれます)
- すべてのデータが SWAT システムによって管理されるルート最適化 (Integration API と呼 ばれます)
この後者の API グループは、インテグレーターが Logistics Route Generate や People Transportation などの SWAT アプリケーションとデータを交換することも可能にします。これにより、ERP、TMS、WMS、OMS、Google スプレッドシート、その他のシステム、および SWAT アプリケーションスイート間のワークフローの自動化が容易になります。
SWAT API は複数の処理パイプラインをサポートしており、以下を含む幅広い操作が可能です。
- オンデマンド操作: 注文はリアルタイムでフリートに割り当てられます。
- 事前注文操作: 注文は最適化の前にグループ化されます。
- 高度な制約: ドライバーの休憩、たるみ管理、変動する車両コスト、一時的な道路制限、車両利用効率、同じ車両での特定の注文の禁止、ジオフェンシング、ドライバーの勤務シフトなどの要因を最適化します。
- 割り当てられたルートの手動編集
- 注文の自動および手動分割とグループ化
- 島の配達、複数の配送センターのサポート
- 完全な集荷-配達サポート: 複数地点の集荷と配達、および「スター」配達モデルをサポートします。
- ... その他多数
SWAT ルート生成は、SWAT GIS チームによって慎重にキュレーションおよび維持されている、運用地域の特定の特性を反映したハイパーローカライズされたマップを使用します。予期しないルート生成結果が発生した場合は、[service@swatmobility.com] のフレンドリーなチームにお問い合わせください。
業界の用語に合わせて、ドキュメント全体で一部の用語は同じ意味で使用されています。たとえば、API の観点からは、booking と order は同じエンティティを指します。ただし、order は主にロジスティクスアプリケーションで使用され、booking は乗客アプリケーションで使用されます。
配達プロセス
配達プロセスを理解するには、まず データモデル を確認してください。
プロセスは通常、次の手順で構成されます。
-
SWAT が基本構成をプロビジョニング: SWAT は、プロジェクトの確立、シミュレーションテンプレートの開始、プライマリユーザー資格情報の生成など、インテグレーター向けの重要な基本構成を準備します。各エンドカスタマーには少なくとも 1 つのプロジェクトが割り当てられ、主にユーザー管理目的でユーザー、乗客、およびドライバーのアカウントを分離するためのコンテナーとして機能します。データセンターやフリートの分離など、運用面を分離するためにプロジェクトを利用することはお勧めしません。代わりに、シミュレーションテンプレートとインスタンスがこの機能を果たします。
-
シミュレーションテンプレートの初期構成: SWAT は、プロジェクトの「シミュレーションテンプレート」の初期構成を確立します。これらのテンプレートは、運用を実行するために必要な標準化された構成をカプセル化します。テンプレートは非常に適応性が高く、多数のパラメーターにより、各クライアントの特定の操作を最適化できます。テンプレート作成後、インテグレーターは運用日ごとに設定を自動的に複製し、必要に応じて構成変更を実行できます。
-
Postman コレクションと OpenAPI 仕様: SWAT は、すべての API の Open API 仕様へのアクセスを提供します。
一般的な構成フロー
顧客向けのルーティングを最適化するためにプロジェクトとワークフローを構成することは困難な場合がありますが、不可能ではありません。SWAT カスタマーサポートチームは通常、このタスクを処理し、各顧客の運用ニーズに合った最適なルート効率を確保します。
はじめに
Postman コレクションを調べて始めましょう
用語
このガイドの用語セクションを確認してください。用語
ユースケース
SWAT ルート最適化機能は非常に柔軟で、さまざまなコスト関数 (最適化基準) と 200 以上のさまざまな制約をサポートしているため、インテグレーターはビジネスオペレーションに一致する方法でエンジンを構成できます。Postman コレクションにリンクされたアップケースの例と、制約とコスト関数が互いにどのように作用するかを理解するのに役立つプレイグラウンドを用意しました。
最適化問題のクラス
SWAT 最適化エンジンは、次のクラスの最適化問題に対処できます。
- 1 台の車両でのルート最適化 (巡回セールスマン問題)
- 複数台の車両でのルート最適化
- 容量制限のある車両でのルート最適化
- 集荷と配達を伴うルートと車両の割り当ての最適化
- 時間枠のある集荷と配達を伴うルートと車両の割り当ての最適化
SWAT 最適化機能は、柔軟な最適化基準と制約をサポートしており、車両の使用を最小限に抑え、より短い走行距離でより多くの注文を完了し、同時に優れた顧客体験を提供しながら、運用上実行可能なルートを作成し、安全性と地域の労働規制を満たすことができます。
運用モード
SWAT API は、次のようなさまざまなシナリオをサポートするために、多数の運用モードを提供します。
- 予約ありまたはなしの静的ルート最適化 (DFR)
- ジャストインタイムルート最適化 (JIT)
- ライブ運用のためのオンデマンド (On Demand) サポート
- オンデマンドと事前計画ルートの組み合わせ
- ウェーブ計画とマルチ DC 計画
インテグレーターおよび API コンシューマーとのエンゲージメント
SWAT は、インテグレーターがすぐに利用できるようにすることに重点を置いています。これを達成するために、当社のチームから専任のサービスデリバリーリードを割り当て、SWAT サービスがお客様の運用および IT システムに最適に適合する方法を特定するのを支援します。お客様のチームがリアルタイムで当社のチームメンバーとデータ、機能、およびプロセスについて共同作業できる専用のワークスペースを確立します。
データモデル
SWAT は、フィールド操作を表す包括的なデータモデルを使用しています。データモデル内のオブジェクトの関係を確認してください。
API リファレンス
API リファレンス は、すべてのエンドポイントの完全なドキュメントを提供します