Locations: get

Requires authorization

Gets a single location by ID. See an example.

Request

HTTP request

GET https://www.googleapis.com/mirror/v1/locations/id

Parameters

Parameter name	Value	Description
Path parameters
id	string	The ID of the location or latest for the last known location.

Authorization

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/glass.timeline
https://www.googleapis.com/auth/glass.location

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a Locations resource in the response body.

Examples

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).

Java

Uses the Java client library.

import com.google.api.services.mirror.Mirror;
import com.google.api.services.mirror.model.Location;

import java.io.IOException;

public class MyClass {
  // ...

  /**
   * Print information about the latest known location for the current user.
   *
   * @param service Authorized Mirror service.
   */
  public static void printLatestLocation(Mirror service) {
    try {
      Location location = service.locations().get("latest").execute();

      System.out.println("Location recorded on: " + location.getTimestamp());
      System.out.println("  > Lat: " + location.getLatitude());
      System.out.println("  > Long: " + location.getLongitude());
      System.out.println("  > Accuracy: " + location.getAccuracy() + " meters");
    } catch (IOException e) {
      System.err.println("An error occurred: " + e);
    }
  }

  // ...
}

.NET

Uses the .NET client library.

using System;

using Google.Apis.Mirror.v1;
using Google.Apis.Mirror.v1.Data;

public class MyClass {
  // ...

  /// <summary>
  /// Print information about the latest known location for the current user.
  /// </summary>
  /// <param name='service'>
  /// Authorized Mirror service.
  /// </param>
  public static void PrintLatestLocation(MirrorService service) {
    try {
      Location location = service.Locations.Get("latest").Fetch();

      Console.WriteLine("Location recorded on: " + location.Timestamp);
      Console.WriteLine("  > Lat: " + location.Latitude);
      Console.WriteLine("  > Long: " + location.Longitude);
      Console.WriteLine("  > Accuracy: " + location.Accuracy + " meters");
    } catch (Exception e) {
      Console.WriteLine("An error occurred: " + e.Message);
    }
  }

  // ...
}

PHP

Uses the PHP client library.

/**
 * Print information about the latest known location for the current user.
 *
 * @param Google_MirrorService $service Authorized Mirror service.
 */
function printLatestLocation($service) {
  try {
    $location = $service->locations->get('latest');

    print 'Location recorded on: ' . $location->getTimestamp() . "\n";
    print '  > Lat: ' . $location->getLatitude() . "\n";
    print '  > Long: ' . $location->getLongitude() . "\n";
    print '  > Accuracy: ' . $location->getAccuracy() . " meters\n";

  } catch (Exception $e) {
    print 'An error occurred: ' . $e->getMessage();
  }
}

Python

Uses the Python client library.

from apiclient import errors
# ...

def print_latest_location(service):
  """Print information about the latest known location for the current user.

  Args:
    service: Authorized Mirror service.
  """
  try:
    location = service.locations().get(id='latest').execute()

    print 'Location recorded on: %s' % location.get('timestamp')
    print '  > Lat: %s' % location.get('latitude')
    print '  > Long: %s' % location.get('longitude')
    print '  > Accuracy: %s meters' % location.get('accuracy')
  except errors.HttpError, e:
    print 'An error occurred: %s' % e

Ruby

Uses the Ruby client library.

##
# Print information about the latest known location for the current user.
#
# @param [Google::APIClient] client
#   Authorized client instance.
# @return nil
def print_latest_location(client)
  mirror = client.discovered_api('mirror', 'v1')
  result = client.execute(
    :api_method => mirror.locations.get,
    :parameters => { 'id' => 'latest' })
  if result.success?
    location = result.data
    puts "Location recorded on: #{location.timestamp}"
    puts "  > Lat: #{location.latitude}"
    puts "  > Long: #{location.longitude}"
    puts "  > Accuracy: #{location.accuracy} meters"
  else
    puts "An error occurred: #{result.data['error']['message']}"
  end
end

Go

Uses the Go client library.

import (
        "code.google.com/p/google-api-go-client/mirror/v1"
        "fmt"
)

// PrintLatestLocation prints information about the latest known location for
// the current user.
func PrintLatestLocation(g *mirror.Service) error {
        l, err := g.Locations.Get("latest").Do()
        if err != nil {
                fmt.Printf("An error occurred: %v\n", err)
                return err
        }
        fmt.Printf("Location recorded on: %s\n", l.Timestamp)
        fmt.Printf("  > Lat: %s\n", s.Latitude)
        fmt.Printf("  > Long: %s\n", s.Longitude)
        fmt.Printf("  > Accuracy: %s meters\n", s.Accuracy)
        return nil
}

Raw HTTP

Does not use a client library.

GET /mirror/v1/locations/latest HTTP/1.1
Authorization: Bearer auth token