ガイドAPIリファレンス
ガイド

テスト段階の機能の詳細

お客様に安定した高パフォーマンスの製品を提供するため、機能が明確で使いやすくなるまでに何度も反復的に改良を行う場合があります。 このフェーズでのお客様のフィードバックは、当社の製品を改良し、お客様のニーズに合わせて明確に定義されたAPIと価値のある機能を提供するために非常に重要です。

したがって、当社は透明性を確保しながらテスト段階の機能へのアクセスを提供することに取り組んでいます。不安定な機能やテスト段階の機能にはわかりやすくマークされているため、開発状況を理解しながら新しい機能を試すことができます。

成熟度レベルAPIの安定性機能の成熟度開発者ガイドの説明OpenAPIの属性OpenAPIの説明
ALPHA不安定 - 今後重大な変更がある可能性ありSLAなし、本番環境での使用は非推奨「ALPHA」タグが付いた機能は開発の途中段階にあります。変更される場合や、まれに削除される場合があります。後方互換性は保証されておらず、バグのサービスレベル契約(SLA)も適用されません。ALPHA機能を使用している場合、本番環境では使用しないことをお勧めします。x-maturity:alphadescription:ALPHA...
BETA安定版SLAなし、本番環境で使用しても問題ないが制限あり「BETA」タグが付いた機能は開発の終了段階にあります。このような機能には後方互換性があり、削除されることはありません。重大なバグはないものの、カバレージ、品質、パフォーマンス、テスト カバレージは最終的なものではありません。このような制約と動作が改善される可能性に合意したお客様は、アプリケーションでBETA機能を安全にご利用いただけます。x-maturity:betadescription:BETA ...

例:

    VehicleMinStopsCountLimit:
      x-maturity: alpha
      description: |
        **ALPHA** Hard limit on the minimum number of stops in a shift.
        Please consult the developer guide for more information before using this feature. 
        To enable it, add `minStops` flag to `experimentalFeatures` configuration in the problem.
      type: object

テスト段階の機能を有効にする

テスト段階の機能を有効にするには、有効にしたい機能の名前を含むexperimentalFeatures配列を問題構成に追加します。

{
  "configuration": {
    "experimentalFeatures": [
      "experimentalFeature1",
      "experimentalFeature2"
    ]
  },
  "fleet": {},
  "plan": {}
}

機能フラグが正しくない場合は検証エラーが返されます。

{
    "title": "BAD_REQUEST",
    "status": 400,
    "code": "E613500",
    "cause": "Unsupported experimental feature flag \"wrongFeatureFlag\".",
    "action": "",
    "correlationId": ""
}

現在サポートされている実験的 (アルファ) 機能フラグ:

機能フラグ説明
minStops1回のシフトで車両が停車する最小の数を定義できます。詳細については、「運行管理」を参照してください。
restTimes勤務時間に応じて休憩を定義できます。
clusterNearby停車地の作成方法と、近くのアクティビティをクラスター化する方法を定義できます。詳細については、「運行管理」を参照してください。
advancedObjectives高度な目的関数を定義できます。詳細については、「高度な目標」を参照してください。
softTimeWindowsある程度の違反を許容することで全体的によりよいソリューションが得られる場合、違反を許容する時間枠を定義できます。詳細については、「ソフト時間枠」を参照してください。
houseKeys同じ顧客の場所で提供する複数のジョブからなるサービスの所要時間を制御できます。詳細については、「顧客ベースのサービス所要時間」を参照してください。
rechargesEV充電ポイントを定義できます。詳細については、「運行管理」を参照してください。
flexibleGroups旅程内のどこでも対応可能だが、1台の車両でしか対応できない柔軟なジョブグループを定義できます。詳細については、「ジョブグループとPUDO」を参照してください。
ignoreTrafficViolationsルートの計算時に交通違反を無視できます。詳細については、「運行管理」を参照してください。
parkingIdsジョブで駐車場を指定できます。
multipleUnassignedReasons未割り当てジョブの複数の未割り当て理由を取得できます。