谷歌地图DistanceMatrixService无法将公里转换为英里问题求助

开发者阿泽

2026-5-21

解决Google Maps DistanceMatrixService英里单位不生效的问题

看起来你已经设置了unitSystem: google.maps.UnitSystem.IMPERIAL但没达到预期效果，我来帮你排查下可能的问题，以及给出可行的解决方案：

先确认结果处理逻辑是否正确
DistanceMatrixService返回的结果里，distance对象包含两个属性：value（以米为单位的数值，和单位设置无关）和text（根据你设置的unitSystem格式化后的带单位文本）。如果你的代码直接用了value自行转换，那自然不会显示英里。正确的做法是读取text字段，它会自动显示为英里格式（比如"5.3 mi"）。

给你一个完整的调用示例，包含正确的结果处理：

var service = new google.maps.DistanceMatrixService();
service.getDistanceMatrix({
  origins: [source],
  destinations: [destination],
  travelMode: google.maps.TravelMode.DRIVING,
  unitSystem: google.maps.UnitSystem.IMPERIAL, // 这里设置英制单位
  avoidHighways: false,
  avoidTolls: false
}, function(response, status) {
  if (status == google.maps.DistanceMatrixStatus.OK) {
    var origin = response.originAddresses[0];
    var destination = response.destinationAddresses[0];
    var distance = response.rows[0].elements[0].distance;
    console.log(`从${origin}到${destination}的距离是：${distance.text}`);
    // 这里的distance.text会显示为英里单位，比如"10.2 mi"
  } else {
    console.error('Distance Matrix请求失败：' + status);
  }
});

检查API版本是否兼容
确保你加载的Google Maps JavaScript API是较新的稳定版本，虽然UnitSystem.IMPERIAL很早就支持了，但旧版本可能存在兼容性问题。建议加载API时指定版本，比如：
```
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=weekly"></script>
```
验证起点和终点的有效性
如果source或destination不是有效的地址/坐标，DistanceMatrixService可能会返回默认的单位设置。可以先在Google Maps官网测试下这两个地点是否能正确解析，确保它们是合法的位置值。
确认没有覆盖单位设置
检查代码中是否有其他地方修改了单位相关的配置，比如全局的地图设置或者其他DistanceMatrix调用覆盖了这个参数。

如果按照上面的步骤排查后还是有问题，可以把你的结果处理代码贴出来，这样能更精准地定位问题~

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