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

作者:API传播员 · 2025-10-20 · 阅读时间:4分钟

本快速入门指南将带您了解如何通过使用Google Maps API,帮助您轻松实现多种功能,例如将地址转换为地理坐标,以及计算两地之间的行程距离和时间。本文将详细介绍相关步骤和代码示例,助您快速上手。


如何使用Python调用Google Maps API

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

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

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

常用API简介

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

获取API密钥

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

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

使用地理编码API获取地址的经纬度

地理编码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("无法获取地理编码信息")

示例输出

纬度:50.08138847866026 经度:14.425403029872987

使用距离矩阵API计算行程距离和时间

距离矩阵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("无法获取距离矩阵信息")

示例输出

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

后续步骤

在使用Google Maps API时,您可能会遇到一些限制,例如每日请求配额或速率限制。如果您需要突破这些限制,可以参考我们关于突破Google Places API限制的逐步指南,以获取更多实用技巧。

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

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