谷歌地图服务节点.js 客户端
这个图书馆已经贬值了,有利于 @googlemaps/google-maps-服务-js。错误修正将继续下去,但所有新特性开发都将在 主分支 并出版到新图书馆.
用节点? 喜欢 地理编码 什么东西? 寻找
页:1 方向? 吗?
这个图书馆带来了 谷歌地图 API 网络服务 到您的节点js
应用.
Google Maps 服务的节点客户端是一个节点.js客户端库 用于下列谷歌地图 API:
记住,同样的 条款和条件 适用于通过此库访问的API的使用.
请注意!
这个库是为服务器端的Node.js应用程序而设计的. 尝试在浏览器或任何其他环境中使用它客户端,比如React Industrial,在某些情况下可能可行,但大多不会成功. 请在试图利用这些环境时不要报告与这些环境有关的问题,因为 服务器侧 Node.js 应用程序是此库唯一支持的环境对于其他环境,请尝试 地图 JavaScript API,其中包含可比较的功能集,并明确用于客户端JavaScript.
特征
-
在失败时重试 间歇性故障时自动重试 . 也就是说,当任何可重试的5xx错误从API中返回时.
-
限制费率 请求受客户的费率限制,这有助于 防止达到服务器强制费率限制.
快速启动
$ npm install @google/maps
说明: 您需要安装 npm 2. 7.0 或 更多, 因为这个库是一个主机 范围软件包。 。 。 .
通过调用创建新客户端对象 createClient()
const googleMapsClient = require('@google/maps').createClient({
key: 'your API key here'
});
通过调用客户端对象上的方法向Google Maps API请求.
// Geocode an address.
googleMapsClient.geocode({
address: '1600 Amphitheatre Parkway, Mountain View, CA'
}, function(err, response) {
if (!err) {
console.log(response.json.results);
}
});
你也可以使用基于承诺的解决办法.
const googleMapsClient = require('@google/maps').createClient({
key: 'your API key here',
Promise: Promise
});
googleMapsClient.geocode({address: '1600 Amphitheatre Parkway, Mountain View, CA'})
.asPromise()
.then((response) => {
console.log(response.json.results);
})
.catch((err) => {
console.log(err);
});
更多信息请查看 测试。 。 。 .
查看 参考文件
包括网络服务的其他文件可在下列网址查阅: https://developers.google.com/maps/ 页面存档备份,存于互联网档案馆。 。 。 .
API 密钥
每个Google Maps Web Service请求都需要一个API密钥. 要获得 API 密钥, 请遵循 获取 API 密钥 (原始内容存档于2018-03-21). Professional in our maps JS API docs.
当您有 API 密钥时, 您可以创建客户端对象 :
var googleMapsClient = require('@google/maps').createClient({
key: 'your API key here'
});
客户身份
Google Maps APIs Premium 计划客户可以使用他们的 客户身份和秘密 要认证, 而不是 API 密钥 .
var googleMapsClient = require('@google/maps').createClient({
clientId: 'Add your client ID here',
clientSecret: 'Add your client secret here',
});
重要内容: 此密钥应保密于您的服务器 .
字体
该图书馆的社区建设打字机可使用 @types/google__maps (注意双下划线).
npm install @types/google__maps
发展中国家
为了进行端到端测试,您需要通过一个 环境变量.
$ export GOOGLE_MAPS_API_KEY=AIza-your-api-key
$ npm test
支助
这个图书馆是社区支持的。 我们很自在 我们想要你建立真正的图书馆的稳定性和特征 生产应用。 我们会尽力支持,通过Stack 过度流出、图书馆的公共表面和维护 向后兼容;然而,当库处于 0.x版本,我们保留了让反相兼容的权利 变化。 如果我们确实去掉了一些功能(通常是因为更好) 功能存在或特性证明不可行时,我们的意图 即对开发者进行贬值并给予一年时间更新其代码.
如果您发现错误, 或者有特性建议, 请 日志一个问题请阅读 如何贡献。 。 。 .
命令行接口
通过 npm 安装也提供了 googlemaps 命令行工具,
用于向其他命令行程序管道 JSON 结果:
$ googlemaps directions --origin 'Sydney Town Hall' --destination 'Parramatta, NSW'