需要授權
擷取使用者的位置清單。參閲範例。
要求
HTTP 要求
GET https://www.googleapis.com/mirror/v1/locations
授權
此要求需要至少具備下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
範圍 |
---|
https://www.googleapis.com/auth/glass.timeline |
https://www.googleapis.com/auth/glass.location |
要求主體
請不要透過此方法提供請求主體。
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{ "kind": "mirror#locationsList", "items": [ locations Resource ] }
屬性名稱 | 值 | 說明 | Notes |
---|---|---|---|
kind |
string |
資源類型。一律為 mirror#locationsList 。 |
|
items[] |
list |
地點清單。 |
範例
注意:這個方法適用的程式語言眾多,我們只在此提供部分程式碼範例,完整的支援語言清單請參閱用戶端程式庫頁面。
Java
使用 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
使用 .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); } } // ... }
PHP
使用 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
使用 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
使用 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
並未使用用戶端程式庫。
GET /mirror/v1/locations HTTP/1.1
Host: www.googleapis.com
Authorization: Bearer auth token