使用Python?想要对某些内容进行地理编码吗?寻找路线?也许方向矩阵?该库将 Google Maps Platform Web 服务引入您的 Python 应用程序。
Google 地图服务的 Python 客户端是用于以下 Google 地图 API 的 Python 客户端库:
请记住,通过此库访问 API 时,相同的条款和条件适用于 API 的使用。
该库是社区支持的。我们对该库的稳定性和功能非常满意,我们希望您可以在其上构建真正的生产应用程序。我们将尝试通过 Stack Overflow 支持库的公共和受保护表面,并在未来保持向后兼容性;然而,虽然该库是 0.x 版本,但我们保留进行向后不兼容更改的权利。如果我们确实删除了某些功能(通常是因为存在更好的功能或者该功能被证明不可行),我们的目的是弃用并给开发人员一年的时间来更新他们的代码。
如果您发现错误或有功能建议,请记录问题。如果您想贡献,请阅读贡献。
每个 Google 地图 Web 服务请求都需要 API 密钥或客户端 ID。 API 密钥在 Google Cloud 控制台“API 和服务”选项卡的“凭据”页面中生成。
有关 Google Maps Platform 入门和生成/限制 API 密钥的更多信息,请参阅我们文档中的 Google Maps Platform 入门。
重要提示:此密钥应在您的服务器上保密。
$ pip install -U googlemaps
请注意,如果要指定连接/读取超时,则需要 requests 2.4.0 或更高版本。
此示例使用地理编码 API 和带有 API 密钥的方向 API:
import googlemaps
from datetime import datetime
gmaps = googlemaps . Client ( key = 'Add Your Key here' )
# Geocoding an address
geocode_result = gmaps . geocode ( '1600 Amphitheatre Parkway, Mountain View, CA' )
# Look up an address with reverse geocoding
reverse_geocode_result = gmaps . reverse_geocode (( 40.714224 , - 73.961452 ))
# Request directions via public transit
now = datetime . now ()
directions_result = gmaps . directions ( "Sydney Town Hall" ,
"Parramatta, NSW" ,
mode = "transit" ,
departure_time = now )
# Validate an address with address validation
addressvalidation_result = gmaps . addressvalidation ([ '1600 Amphitheatre Pk' ],
regionCode = 'US' ,
locality = 'Mountain View' ,
enableUspsCass = True )
# Get an Address Descriptor of a location in the reverse geocoding response
address_descriptor_result = gmaps . reverse_geocode (( 40.714224 , - 73.961452 ), enable_address_descriptor = True )
有关更多使用示例,请查看测试。
发生间歇性故障时自动重试。也就是说,当从 API 返回任何可重试的 5xx 错误时。
# Installing nox
$ pip install nox
# Running tests
$ nox
# Generating documentation
$ nox -e docs
# Copy docs to gh-pages
$ nox -e docs && mv docs/_build/html generated_docs && git clean -Xdi && git checkout gh-pages
google-maps-services-python
库的文档