Google Routes API无路线判断及响应字段可空性技术问询

测试的边缘场景 #

• 起点和终点均为海上点位
• 起点和终点均为陆地点位但距离极近（<10米）

海上点位场景的请求与响应 #

computeRoutes请求 #

{
    "origin": {
        "location": {
            "latLng": {
                "latitude": 33.29970432790808,
                "longitude": 35.070910203529856
            }
        }
    },
    "destination": {
        "location": {
            "latLng": {
                "latitude": 33.299996850855344,
                "longitude": 35.070292786688945
            }
        }
    },
    "travelMode": "DRIVE",
    "computeAlternativeRoutes": false,
    "languageCode": "en-US",
    "units": "IMPERIAL"
}

computeRouteMatrix请求 #

{
    "origins": [
        {
            "waypoint": {
                "location": {
                    "latLng": {
                        "latitude": 33.29970432790808,
                        "longitude": 35.070910203529856
                    }
                }
            }
        }
    ],
    "destinations": [
        {
            "waypoint": {
                "location": {
                    "latLng": {
                      "latitude": 33.29970432790808,
                      "longitude": 35.070910203529856
                    }
                }
            }
        }
    ]
}

响应结果 #

computeRoutes响应：

{}

computeRouteMatrix响应：

[
    {
        "originIndex": 0,
        "destinationIndex": 0,
        "status": {},
        "condition": "ROUTE_NOT_FOUND"
    }
]

结果对比 #

computeRoutes仅返回空JSON对象，无有效状态标识；而computeRouteMatrix会为每对起终点返回带有ROUTE_NOT_FOUND标识的condition字段。

技术疑问 #

1. 是否可依赖computeRoutes的空响应判断无路线？文档未提及该场景。
2. 是否可依赖computeRouteMatrix响应中的condition字段判断无路线？
3. 如何知晓这两个接口响应字段的可空性？我需为该API创建Dart接口（支持空安全），但文档未说明响应字段的可空情况。

内容的提问来源于stack exchange，提问作者HHH