メインコンテンツまでスキップ

SWAT API の概要 (Introduction to SWAT API)

SWAT は3つの API 製品を提供しています。

  • Stateless API: VRP ソルバー テクノロジーへのアクセスを提供します。最大限の柔軟性を提供しますが、より複雑な統合が必要です。SWAT システムは、この API を使用する場合、顧客データを保存または保持しません。
  • 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 Route Generation は、SWAT GIS チームによって慎重にキュレーションおよび維持された、運用地域の特定の特性を反映したハイパーローカライズされたマップを使用します。予期しないルート生成結果が発生した場合は、[service@swatmobility.com] のフレンドリーなチームにお問い合わせください。

ヒント

業界の用語に合わせるために、ドキュメント全体でいくつかの用語が交換可能に使用されています。たとえば、API の観点からは、booking と order は同じエンティティを指します。ただし、order は主に物流アプリケーションに使用され、booking は乗客アプリケーションに使用されます。

配信プロセス (Delivery process)​

配信プロセスを理解するには、まず データモデル を確認してください。

プロセスには通常、次の手順が含まれます。

  1. SWAT が基本構成をプロビジョニング: SWAT は、プロジェクトの確立、シミュレーションテンプレートの開始、および主要なユーザー資格情報の生成を含む、インテグレーター向けの基本的な構成を準備します。各エンドカスタマーには少なくとも1つのプロジェクトが割り当てられ、主にユーザー管理の目的でユーザー、乗客、およびドライバーのアカウントを分離するためのコンテナとして機能します。運用面（個別のデータセンターやフリートなど）を分離するためにプロジェクトを使用することはお勧めしません。代わりに、シミュレーションテンプレートとインスタンスがこの機能を果たします。

  2. シミュレーションテンプレートの初期構成: SWAT は、プロジェクトの「シミュレーションテンプレート」の初期構成を確立します。これらのテンプレートは、操作を実行するために必要な標準化された構成をカプセル化します。テンプレートは適応性が高く、各クライアントの特定の操作を最適化するための多数のパラメーターがあります。テンプレートの作成後、インテグレーターは運用日ごとに設定を自動的に複製し、必要に応じて構成の変更を実行できます。

  3. Postman コレクションと OpenAPI 仕様: SWAT は、すべての API の Open API 仕様へのアクセスを提供します。

一般的な構成フロー (Typical configuration flow)​

顧客向けのルーティングを最適化するためのプロジェクトとワークフローの構成は困難な場合がありますが、不可能ではありません。SWAT カスタマーサポートチームは通常、このタスクを処理し、各顧客の運用ニーズに合った最適なルート効率を確保します。

はじめに (Getting Started)​

Postman コレクションを探索して始めましょう

Run In Postman

用語 (Terminology)​

このガイドの用語セクションを確認してください。用語

ユースケース (Use cases)​

SWAT ルート最適化機能は非常に柔軟で、さまざまなコスト関数（最適化基準）と200以上のさまざまな制約をサポートしており、インテグレーターはビジネス運用に合わせた方法でエンジンを構成できます。Postman コレクションにリンクされたユースケースの例と、制約とコスト関数が互いにどのように機能するかを理解するのに役立つプレイグラウンドを用意しました。

最適化問題のクラス (Classes of optimization problems)​

SWAT 最適化エンジンは、次のクラスの最適化問題に対処できます。

  • 1台の車両によるルート最適化（巡回セールスマン問題）
  • 複数の車両によるルート最適化
  • 容量制限のある車両によるルート最適化
  • ピックアップと配達を伴うルートおよび車両割り当て最適化
  • 時間枠付きのピックアップと配達を伴うルートおよび車両割り当て最適化

SWAT 最適化機能は、車両の使用を最小限に抑え、より短いマイレージでより多くの注文を完了し、同時に優れた顧客体験を提供しながら、運用上実行可能なルートを作成し、安全性と労働に関する地域の規制を満たすことができる柔軟な最適化基準と制約をサポートします。

運用モード (Operational modes)

SWAT API は、以下を含むさまざまなシナリオをサポートするための多数の運用モードを提供します。

  • 予約ありまたはなしの静的ルート最適化（DFR）
  • ジャストインタイムルート最適化（JIT）
  • ライブ運用のためのオンデマンド（オンデマンド）サポート
  • オンデマンドと事前計画ルートの組み合わせ
  • ウェーブ計画とマルチ DC 計画

インテグレーターおよび API コンシューマーとのエンゲージメント (Our engagement with integrators and API consumers)​

SWAT は、インテグレーターがすぐに稼働できるようにすることに重点を置いています。これを達成するために、私たちのチームから専任のサービスデリバリーリードを割り当て、SWAT サービスがお客様の運用および IT システムに最適に適合する方法を特定するのを支援します。貴社のチームがデータ、機能、プロセスについて、当社のチームメンバーとリアルタイムで共同作業できる専用のワークスペースを確立します。

データモデル (Data model)​

SWAT は、現場運用を表す包括的なデータモデルを使用しています。データモデル内のオブジェクトの関係を確認してください。

API リファレンス (API Reference)​

  • API リファレンス は、すべてのエンドポイントの完全なドキュメントを提供します