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

تستخدم مكتبة عميل جافا.

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

استخدام مكتبة عملاء Ruby

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

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