python-gmaps 0.3.1

为什么还需要另一个Python Google Maps客户端？

有多个库用于Google Maps Web服务。例如：* googlemaps * google.directions

它们有什么问题？googlemaps使用了已弃用的Google API，并强迫你格式化参数而不是使用原生的Python数据类型。那么google.directions呢？只需看看它的代码...

所以这里有新的Google Maps API端点的代码。它需要requests，支持原生Python数据类型，并添加了一些语法糖。仅此而已。没有铃铛和哨子。

欢迎任何贡献（代码/问题）。

安装

pip install python-gmaps

用法

只需导入您选择的API端点并开始查询

from gmaps import Geocoding
api = Geocoding()

api.geocode("somwhere")
api.reverse(51.123, 21.123)

如果您需要使用Google Maps API for Business，请使用api_key参数实例化您的端点

from gmaps import Geocoding
api = Geocoding(api_key='your_secret_api_key')

每个端点方法在查询状态不是OK时抛出适当的异常。它还将结果列表从Google API输出字典中提取出来，因此您有一个更少的键可以访问，但它不会做更多的事情。因此，如果Google geocoding api输出如下

{
    results: [
    ...
    ],
    status: 'OK'
}

您将只得到在result值内部的列表。至少返回一个元素总是得到保证，否则将抛出gmnaps.errors.NoResults异常。

对于每个API端点，您可以指定：* 默认传感器值 * 协议（http/https） * API密钥（仅限http）

可用端点：* Geocoding() * Directions() * Timezone() * Elevation()

有关每个端点的详细文档，请参阅docstrings或此API文档。如果您需要某些参数（如地理编码组件、语言、区域等）的可用值列表，请参阅Google Maps API文档。这些值可能会随时更改，因此没有必要在此库中检查它们——它们将无论如何进行检查。

变更