com.google.gwt.geolocation.client.Position Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of vaadin-client Show documentation

Vaadin is a web application framework for Rich Internet Applications (RIA). Vaadin enables easy development and maintenance of fast and secure rich web applications with a stunning look and feel and a wide browser support. It features a server-side architecture with the majority of the logic running on the server. Ajax technology is used at the browser-side to ensure a rich and interactive user experience.

There is a newer version: 8.25.2

Show newest version

/*
 * Copyright 2011 Google Inc.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */

package com.google.gwt.geolocation.client;

import com.google.gwt.core.client.SingleJsoImpl;
import com.google.gwt.geolocation.client.PositionImpl.CoordinatesImpl;

/**
 * Represents information about the user's position as reported by the browser.
 */
@SingleJsoImpl(PositionImpl.class)
public interface Position {

  /**
   * Returns information about the coordinates reported by the browser.
   */
  Coordinates getCoordinates();

  /**
   * Returns the time this position was reported by the browser.
   */
  double getTimestamp();

  /**
   * Represents position reported by the browser.
   */
  @SingleJsoImpl(CoordinatesImpl.class)
  public interface Coordinates {

    /**
     * Returns the estimated accuracy reported by the browser, in meters.
     */
    double getAccuracy();

    /**
     * Returns the altitude reported by the browser, in meters, above the reference
     * ellipsoid, or null if the browser did not report an
     * altitude.
     */
    Double getAltitude();

    /**
     * Returns the estimated accuracy of the altitude reported by the browser,
     * in meters, or null if the browser did not report an
     * accuracy.
     */
    Double getAltitudeAccuracy();

    /**
     * Returns the heading, in degrees from due north, reported by the browser,
     * based on previous calls to get the user's position, or null
     * if the browser did not report a heading.
     */
    Double getHeading();

    /**
     * Returns the decimal latitude reported by the browser.
     */
    double getLatitude();

    /**
     * Returns the decimal longitude reported by the browser.
     */
    double getLongitude();

    /**
     * Returns the speed, in meters/second, reported by the browser, based on
     * previous calls to get the user's position, or null if the
     * browser did not report a speed.
     */
    Double getSpeed();
  }
}