概念和用法
通常,要在地图上标出用户的位置或显示与用户地理位置相关的个性化信息时,我们需要在 web 应用程序中检索用户的位置信息。
地理位置 API 是通过调用 navigator.geolocation 来访问的;这将使得用户的浏览器请求获得用户位置数据相关的权限。如果用户授予了权限,则浏览器将使用设备上可用的最佳方式来获取此信息(例如 GPS)。
开发人员现在可用通过不同的方式访问位置信息:
Geolocation.getCurrentPosition():检索设备的当前位置。
Geolocation.watchPosition():注册一个处理函数,在设备位置发生改变时都会自动调用,并返回改变后的位置信息。
对于上述的几种方法,其回调函数最多有三个参数:
一个必须的成功的回调函数:如果位置检索成功,则调用该回调函数,并以 GeolocationPosition 对象(用于提供位置数据)作为其唯一的参数。
一个可选的错误回调函数:如果位置检索失败,则调用该回调函数,并以 GeolocationPositionError 对象(用于提供访问出错的信息)作为其唯一的参数。
一个可选的对象:用于提供检索位置数据的选项。
有关地理位置使用的信息,请参阅使用地理位置 API。