summaryrefslogtreecommitdiffstats
path: root/chrome/browser/geolocation/geoposition.h
blob: 71436382ac3aba3b628142f9bbf4d171ef81d619 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
// Copyright (c) 2010 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

// This file declares the Position structure, which is used to represent a
// position fix. Originally derived from
// http://gears.googlecode.com/svn/trunk/gears/geolocation/geolocation.h

#ifndef CHROME_BROWSER_GEOLOCATION_GEOPOSITION_H_
#define CHROME_BROWSER_GEOLOCATION_GEOPOSITION_H_

#include "base/string16.h"

// The internal representation of a position. Some properties use different
// types when passed to JavaScript.
struct Position {
 public:
  // Error codes for returning to JavaScript. These values are defined by the
  // W3C spec. Note that Gears does not use all of these codes, but we need
  // values for all of them to allow us to provide the constants on the error
  // object.
  enum ErrorCode {
    ERROR_CODE_NONE = 0,               // Chrome addition
    ERROR_CODE_PERMISSION_DENIED = 1,
    ERROR_CODE_POSITION_UNAVAILABLE = 2,
    ERROR_CODE_TIMEOUT = 3,
  };

  Position();

  bool is_valid_latlong() const;
  bool is_valid_altitude() const;
  bool is_valid_accuracy() const;
  bool is_valid_altitude_accuracy() const;
  bool is_valid_timestamp() const;

  // A valid fix has a valid latitude, longitude, accuracy and timestamp.
  bool IsValidFix() const;

  // A position is considered initialized if it has either a valid fix or
  // an error code other than NONE.
  bool IsInitialized() const;

  // These properties correspond to the JavaScript Position object.
  double latitude;           // In degrees
  double longitude;          // In degrees
  double altitude;           // In metres
  double accuracy;           // In metres
  double altitude_accuracy;  // In metres
  int64 timestamp;           // Milliseconds since 1st Jan 1970

  // These properties are returned to JavaScript as a PositionError object.
  ErrorCode error_code;
  std::wstring error_message;  // Human-readable error message
};

#endif  // CHROME_BROWSER_GEOLOCATION_GEOPOSITION_H_