Python 调用 Google Maps API 实战指南:地理编码与距离矩阵快速上手

作者:API传播员 · 2025-10-20 · 阅读时间:4分钟
本指南详细介绍了如何在Python中使用Google Maps API,包括获取API密钥、使用地理编码API将地址转换为经纬度坐标,以及利用距离矩阵API计算两地之间的驾驶距离和时间。通过具体的代码示例,帮助开发者快速实现这些功能。

一. 如何使用 Python 调用 Google Maps API

在开始之前,请确保您已满足以下条件:

  1. 拥有一个有效的 Google 账户。
  2. 已在系统中安装 Python 环境。
  3. 安装了必要的 Python 库,例如 requests

此外,您可以参考我们关于 Python 与 API 的综合指南,其中详细介绍了如何使用 Python 与 API 交互、requests 库的使用方法以及常见 HTTP 方法,同时还包含一些高级技巧和故障排除内容。

1. 常用 API 简介

  • Geocoding API:用于实现地址与地理坐标之间的相互转换。
  • Distance Matrix API:用于获取多个目的地之间的行程时间和距离信息。

2. 获取 API 密钥

在使用 Google Maps API 之前,您需要获取一个 API 密钥。以下是具体步骤:

  1. 登录 Google Cloud 平台。
  2. 点击左上角导航栏中的“API 和服务”菜单项。
  3. 选择“启用 API 和服务”。
  4. 转到“凭据”页面,点击“创建凭据”。
  5. 选择“API 密钥”,生成并复制您的 API 密钥。

二. 使用 Geocoding API 获取地址的经纬度

Geocoding API 可以帮助我们将地址转换为经纬度坐标。以下是一个简单的 Python 示例代码:

import requests

# 替换为您的 API 密钥
API_KEY = '您的API密钥'
address = 'Prague, Czech Republic'
url = f'https://maps.googleapis.com/maps/api/geocode/json?address={address}&key={API_KEY}'

response = requests.get(url)
data = response.json()

if data['status'] == 'OK':
    location = data['results'][0]['geometry']['location']
    print(f"纬度:{location['lat']} 经度:{location['lng']}")
else:
    print("无法获取地理编码信息")

1. 示例输出

纬度:50.08138847866026 经度:14.425403029872987

三. 使用 Distance Matrix API 计算行程距离和时间

Distance Matrix API 可以帮助您获取两个地点之间的驾驶距离和时间。以下是一个示例代码:

import requests

# 替换为您的 API 密钥
API_KEY = '您的API密钥'
origin = 'Prague, Czech Republic'
destination = 'Brno, Czech Republic'
url = f'https://maps.googleapis.com/maps/api/distancematrix/json?origins={origin}&destinations={destination}&key={API_KEY}'

response = requests.get(url)
data = response.json()

if data['status'] == 'OK':
    element = data['rows'][0]['elements'][0]
    distance = element['distance']['text']
    duration = element['duration']['text']
    print(f"驾驶距离:{distance} 驾驶时间:{duration}")
else:
    print("无法获取距离矩阵信息")

1. 示例输出

驾驶距离:6.7公里 驾驶时间:23分钟

四. 后续步骤

在使用 Google Maps API 时,您可能会遇到一些限制,例如每日请求配额或速率限制。

如果您需要突破这些限制,可以参考我们关于突破 Google Places API 限制的逐步指南,以获取更多实用技巧。

通过本文的介绍,您已经了解了如何使用 Python 调用 Google Maps API,并实现了基本的地理编码和距离计算功能。希望这些内容能帮助您更高效地完成相关任务!


原文链接: https://blog.apify.com/google-maps-api-python/