getLocation 获取定位
简介
getLocation 获取用户的经纬度信息。旧版拼写 getLocaltion 仍可继续使用。
参数
- 可以直接传入
timeout毫秒数,也可以传入{ timeout, enableHighAccuracy, maximumAge }配置对象。
返回值
返回一个 Promise<{ latitude: number; longitude: number }>类型的对象,成功时解析为包含纬度和经度的对象,失败时被拒绝并传递错误信息。
注意事项
- 此函数只能在支持
navigator.geolocationAPI 的现代浏览器中运行。 - 用户必须同意分享他们的位置信息,否则会抛出错误。
- 如果浏览器不在 HTTPS 环境下运行,无法正常工作。确保应用程序部署在 HTTPS 上
示例
js
import { getLocation } from 'cat-tool';
getLocation({ timeout: 5000 })
.then(({ latitude, longitude }) => {
console.log('Location:', latitude, longitude);
})
.catch((error) => {
console.error('Error getting location:', error);
});在线体验
获取位置信息
