如何使用Amadeus API设置航班报价搜索中的maxFlightTime？

Question

我正在Amadeus API上发布航班优惠。

我正在尝试设置maxFlightTime参数。

API文档说明：

maxFlightTime数字示例：200此选项允许修改经过飞行时间（EFT）主Pricer选项的值

• https://developers.amadeus.com/self-service/category/air/api-doc/flight-offers-search/api-reference

我的问题是：这个参数期望什么？留档说一个数字，并提供200作为示例。

这个数字代表什么？是分钟、小时还是其他什么？

Answer 1

使用maxFlightTime有点复杂。该数字是一个百分比，表示您希望查找的航班与这些搜索条件下存在的最短航班相比的时间。

让我们举一个例子：我们正在使用航班报价搜索的后endpoint搜索从MAD到SFO的航班（为了示例，我们只返回一个报价）：

JSON正文：

json prettyprint-override">{
    "currencyCode": "EUR",
    "originDestinations": [
        {
            "id": "1",
            "originLocationCode": "MAD",
            "destinationLocationCode": "SFO",
            "departureDateTimeRange": {
                "date": "2021-05-01",
                "time": "10:00:00"
            }
        }
    ],
    "travelers": [
        {
            "id": "1",
            "travelerType": "ADULT",
            "fareOptions": [
                "STANDARD"
            ]
        }
    ],
    "sources": [
        "GDS"
    ],
    "searchCriteria": {
        "maxFlightOffers": 1,
        "flightFilters": {
            "cabinRestrictions": [
                {
                    "cabin": "ECONOMY",
                    "coverage": "MOST_SEGMENTS",
                    "originDestinationIds": [
                        "1"
                    ]
                }
            ]
        }
    }
}

如果您检查JSON响应，您将看到报价是MAD到IST（持续时间PT4H15M-so 4h15）和IST到SFO（持续时间PT13H20M-so 13h20M），总持续时间为17h35。请注意，此API始终返回给定条件下最便宜的航班报价。

如果现在我们想执行添加maxFlightTime的相同请求，但我们不想进行如此长的旅行，我们希望最大总持续时间比可用的最短飞行时间长110%。

我们可以使用这个JSON主体

json prettyprint-override">{
    "currencyCode": "EUR",
    "originDestinations": [
        {
            "id": "1",
            "originLocationCode": "MAD",
            "destinationLocationCode": "SFO",
            "departureDateTimeRange": {
                "date": "2021-05-01",
                "time": "10:00:00"
            }
        }
    ],
    "travelers": [
        {
            "id": "1",
            "travelerType": "ADULT",
            "fareOptions": [
                "STANDARD"
            ]
        }
    ],
    "sources": [
        "GDS"
    ],
    "searchCriteria": {
        "maxFlightOffers": 1,
        "flightFilters": {
            "maxFlightTime": 110,
            "cabinRestrictions": [
                {
                    "cabin": "ECONOMY",
                    "coverage": "MOST_SEGMENTS",
                    "originDestinationIds": [
                        "1"
                    ]
                }
            ]
        }
    }
}

这是您将得到的响应：MAD到DFWPT10H35M（10h35），然后是DAL（另一个达拉斯机场？）持续时间为PT4H4M（4h04），因此总持续时间为14h39。

这就是为什么最大飞行时间只能在100到999之间。

API规范对此参数不是很清楚，我们将很快更新它。