Locations: get

נדרשת הרשאה

קבלת מיקום יחיד לפי מזהה. לעיון בדוגמה

שליחת בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים של נתיב
id string המזהה של המיקום או latest של המיקום הידוע האחרון.

הרשאה

לבקשה הזו נדרשת הרשאה עם לפחות אחד מהיקפי ההרשאות הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/glass.timeline
https://www.googleapis.com/auth/glass.location

גוף הבקשה

אין להזין גוף בקשה בשיטה זו.

תשובה

אם הצלחת, בשיטה הזו מוחזר משאב מיקומים בגוף התגובה.

דוגמאות

הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).

Java

משתמש בספריית הלקוחות של Java.

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

משתמש בספריית הלקוח מסוג .NET

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

משתמש בספריית הלקוח של PHP.

/**
 * 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

משתמש בספריית הלקוחות של Python.

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

משתמש בספריית הלקוחות של Rubby.

##
# 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

נעשה שימוש בספריית הלקוחות של Go.

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
}

HTTP גולמי

לא נעשה שימוש בספריית לקוח.

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