最終更新:2023-04-28 (金) 10:37:37 (372d)  

navigator.geolocation
Top / navigator.geolocation

https://developer.mozilla.org/ja/docs/Web/API/Navigator/geolocation

関数

  • geolocation.getCurrentPosition?()端末の現在の位置を受け取ります。
    geolocation.watchPosition?()端末の位置が変化するごとに自動的に呼び出され、更新された位置情報を返すハンドラー関数を登録します

引数

  • 成功コールバック(必須): 位置情報の取得に成功した場合、このコールバックが GeolocationPosition? オブジェクトを唯一の引数として実行され、位置情報へのアクセスを提供します。
  • エラーコールバック(オプション): 位置情報の検索に失敗した場合、このコールバックが GeolocationPositionError? オブジェクトを唯一の引数として実行され、何が問題となったかに関するアクセス情報を提供します。
  • 位置データを取得するためのオプションを提供するオプションのオブジェクト。

オプション

  • maximumAge
    • 正の long 値で、キャッシュされた位置を返すことが可能な最大時間をミリ秒単位で表します。 0 に設定した場合、端末はキャッシュされた位置を使用できず、実際の現在位置を取得する必要があることを意味します。 Infinity に設定した場合、端末はキャッシュされた位置をその古さに関係なく返さなければなりません。既定値は 0 です。
  • timeout
    • 正の long 値で、端末が位置を返すために掛けることができる最大時間をミリ秒単位で表します。既定値は Infinity で、 getCurrentPosition?() は位置を取得できるまで返さないという意味です。
  • enableHighAccuracy?
    • 論理値で、アプリケーションが可能な限り正確な結果を受け取ることを望んでいることを示します。もし true で、端末がより正確な位置を提供できる場合は、そのようにします。この場合、応答時間が遅くなったり、消費電力が増加したりすることに注意してください(たとえば、モバイル端末の GPS チップを使用する場合など)。一方、 false の場合、端末はより速く反応したり、より少ない電力を使用することで、リソースを節約することができます。既定値は false です