Locations: list

Cần phải uỷ quyền

Truy xuất danh sách vị trí cho người dùng. Xem ví dụ.

Yêu cầu

Yêu cầu HTTP

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

Ủy quyền

Yêu cầu này cần có sự uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về tính năng xác thực và uỷ quyền).

Phạm vi
https://www.googleapis.com/auth/glass.timeline
https://www.googleapis.com/auth/glass.location

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:

{
  "kind": "mirror#locationsList",
  "items": [
    locations Resource
  ]
}

Tên tài sản	Giá trị	Nội dung mô tả	Ghi chú
kind	string	Loại tài nguyên. Thao tác này luôn là mirror#locationsList.
items[]	list	Danh sách địa điểm.

Ví dụ

Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).

Java

Dùng thư viện ứng dụng Java.

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

import java.io.IOException;

public class MyClass {
  // ...

  /**
   * Print information about all the known locations for the current user.
   * 
   * @param service Authorized Mirror service.
   */
  public static void printAllLocations(Mirror service) {
    try {
      LocationsListResponse locations = service.locations().list().execute();

      for (Location location : locations.getItems()) {
        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

Dùng thư viện ứng dụng.NET.

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

public class MyClass {
  // ...

  /// <summary>
  /// Print information about all the known locations for the current user.
  /// </summary>
  /// <param name="service">Authorized Mirror service.</param>
  public static void PrintAllLocations(MirrorService service) {
    try {
      LocationsListResponse locations = service.Locations.List().Fetch();

      foreach (Location location in locations.Items) {
        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);
    }
  }

  // ...
}

1.199

Dùng thư viện ứng dụng PHP.

/**
 * Print information about all the known locations for the current user.
 *
 * @param Google_MirrorService $service Authorized Mirror service.
 */
function printAllLocations($service) {
  try {
    $locations = $service->locations->listLocations();

    foreach ($locations->getItems() as $location) {
      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

Dùng thư viện ứng dụng Python.

from apiclient import errors
# ...

def print_all_locations(service):
  """Print information about all the known locations for the current user.

  Args:
    service: Authorized Mirror service.
  """
  try:
    location = service.locations().list().execute()

    for location in location.get('items', []):
      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

Dùng thư viện ứng dụng Ruby.

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

HTTP thô

Không sử dụng thư viện ứng dụng.

GET /mirror/v1/locations HTTP/1.1
Host: www.googleapis.com
Authorization: Bearer auth token