Google Routes API的X-Goog-FieldMask参数无效问题求助

核心问题分析 #

Google Routes API v2的X-Goog-FieldMask参数有严格格式要求，你遇到的400错误大概率是字段掩码格式不符合API规范，或是请求体存在隐性格式问题。

分步解决步骤 #

1. 修正FieldMask格式
   API要求字段掩码为扁平的、逗号分隔的顶级字段路径，无需重复routes.前缀（routes是返回的数组对象，API会自动遍历提取元素内的指定字段）。正确写法：

   X-Goog-FieldMask: distanceMeters,duration
   

2. 验证请求体参数完整性
   确保请求体参数完全符合API规范：

   • origin和destination必须嵌套location结构，示例：{ "location": { "latLng": { "latitude": 37.7749, "longitude": -122.4194 } } }
   • travelMode必须是枚举值：DRIVE、WALK、BICYCLE或TRANSIT
   • computeAlternativeRoutes需明确设为布尔值true或false

3. 用Curl测试最简请求
   先排除其他变量，测试最小可用请求：

   curl -X POST "https://routes.googleapis.com/directions/v2:computeRoutes?key=YOUR_API_KEY" \
   -H "Content-Type: application/json" \
   -H "X-Goog-FieldMask: distanceMeters,duration" \
   -d '{
     "origin": {
       "location": {
         "latLng": {
           "latitude": 37.7749,
           "longitude": -122.4194
         }
       }
     },
     "destination": {
       "location": {
         "latLng": {
           "latitude": 37.3382,
           "longitude": -121.8863
         }
       }
     },
     "travelMode": "DRIVE",
     "computeAlternativeRoutes": true
   }'
   

4. 检查API密钥权限
   确认你的API密钥已启用Routes API，且无IP限制、配额耗尽等情况。

常见错误排查点 #

• 禁止在FieldMask中添加routes.前缀
• 确保请求体JSON无语法错误（如逗号遗漏、引号不匹配）
• 使用TRANSIT模式时，需额外指定transitPreferences参数

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