Locations: list
Stay organized with collections
Save and categorize content based on your preferences.
Requires authorization
Retrieves a list of locations for the user.
See an example.
Request
HTTP request
GET https://www.googleapis.com/mirror/v1/locations
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 response body with the following structure:
{
"kind": "mirror#locationsList",
"items": [
locations Resource
]
}
Property name |
Value |
Description |
Notes |
kind |
string |
The type of resource. This is always mirror#locationsList . |
|
items[] |
list |
The list of locations. |
|
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 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
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 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
Uses the PHP client library.
/**
* 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
Uses the Python client library.
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
Uses the Ruby client library.
##
# 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
Raw HTTP
Does not use a client library.
GET /mirror/v1/locations HTTP/1.1
Host: www.googleapis.com
Authorization: Bearer auth token
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-10 UTC."],[[["\u003cp\u003eRetrieves a list of locations for the authorized user, including latitude, longitude, timestamp, and accuracy.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003ehttps://www.googleapis.com/auth/glass.timeline\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/glass.location\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of location resources within the \u003ccode\u003eitems\u003c/code\u003e property.\u003c/p\u003e\n"],["\u003cp\u003eCode examples are provided in Java, .NET, PHP, Python, and Ruby demonstrating how to retrieve and use location data.\u003c/p\u003e\n"]]],[],null,["# Locations: list\n\n**Requires [authorization](#auth)**\n\nRetrieves a list of locations for the user.\n[See an example](#examples).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/mirror/v1/locations\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/glass/authorization)).\n\n| Scope |\n|--------------------------------------------------|\n| `https://www.googleapis.com/auth/glass.timeline` |\n| `https://www.googleapis.com/auth/glass.location` |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"mirror#locationsList\",\n \"items\": [\n locations Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|--------------------------------------------------------------|-------|\n| `kind` | `string` | The type of resource. This is always `mirror#locationsList`. | |\n| `items[]` | `list` | The list of locations. | |\n\nExamples\n--------\n\n**Note:** The code examples available for this method do not represent all supported programming languages (see the [client libraries page](/glass/tools-downloads/client-libraries) for a list of supported languages). \n\n### Java\n\nUses the [Java client library](/glass/tools-downloads/client-libraries). \n\n```java\nimport com.google.api.services.mirror.Mirror;\nimport com.google.api.services.mirror.model.Location;\nimport com.google.api.services.mirror.model.LocationsListResponse;\n\nimport java.io.IOException;\n\npublic class MyClass {\n // ...\n\n /**\n * Print information about all the known locations for the current user.\n * \n * @param service Authorized Mirror service.\n */\n public static void printAllLocations(Mirror service) {\n try {\n LocationsListResponse locations = service.locations().list().execute();\n\n for (Location location : locations.getItems()) {\n System.out.println(\"Location recorded on: \" + location.getTimestamp());\n System.out.println(\" \u003e Lat: \" + location.getLatitude());\n System.out.println(\" \u003e Long: \" + location.getLongitude());\n System.out.println(\" \u003e Accuracy: \" + location.getAccuracy() + \" meters\");\n }\n } catch (IOException e) {\n System.err.println(\"An error occurred: \" + e);\n }\n }\n\n // ...\n}\n```\n\n### .NET\n\nUses the [.NET client library](/glass/tools-downloads/client-libraries). \n\n```css+lasso\nusing System;\nusing Google.Apis.Mirror.v1;\nusing Google.Apis.Mirror.v1.Data;\n\npublic class MyClass {\n // ...\n\n /// \u003csummary\u003e\n /// Print information about all the known locations for the current user.\n /// \u003c/summary\u003e\n /// \u003cparam name=\"service\"\u003eAuthorized Mirror service.\u003c/param\u003e\n public static void PrintAllLocations(MirrorService service) {\n try {\n LocationsListResponse locations = service.Locations.List().Fetch();\n\n foreach (Location location in locations.Items) {\n Console.WriteLine(\"Location recorded on: \" + location.Timestamp);\n Console.WriteLine(\" \u003e Lat: \" + location.Latitude);\n Console.WriteLine(\" \u003e Long: \" + location.Longitude);\n Console.WriteLine(\" \u003e Accuracy: \" + location.Accuracy + \" meters\");\n }\n } catch (Exception e) {\n Console.WriteLine(\"An error occurred: \" + e.Message);\n }\n }\n\n // ...\n}\n```\n\n### PHP\n\nUses the [PHP client library](/glass/tools-downloads/client-libraries). \n\n```php\n/**\n * Print information about all the known locations for the current user.\n *\n * @param Google_MirrorService $service Authorized Mirror service.\n */\nfunction printAllLocations($service) {\n try {\n $locations = $service-\u003elocations-\u003elistLocations();\n\n foreach ($locations-\u003egetItems() as $location) {\n print 'Location recorded on: ' . $location-\u003egetTimestamp() . \"\\n\";\n print ' \u003e Lat: ' . $location-\u003egetLatitude() . \"\\n\";\n print ' \u003e Long: ' . $location-\u003egetLongitude() . \"\\n\";\n print ' \u003e Accuracy: ' . $location-\u003egetAccuracy() . \" meters\\n\";\n }\n } catch (Exception $e) {\n print 'An error occurred: ' . $e-\u003egetMessage();\n }\n}\n```\n\n### Python\n\nUses the [Python client library](/glass/tools-downloads/client-libraries). \n\n```python\nfrom apiclient import errors\n# ...\n\ndef print_all_locations(service):\n \"\"\"Print information about all the known locations for the current user.\n\n Args:\n service: Authorized Mirror service.\n \"\"\"\n try:\n location = service.locations().list().execute()\n\n for location in location.get('items', []):\n print 'Location recorded on: %s' % location.get('timestamp')\n print ' \u003e Lat: %s' % location.get('latitude')\n print ' \u003e Long: %s' % location.get('longitude')\n print ' \u003e Accuracy: %s meters' % location.get('accuracy')\n except errors.HttpError, e:\n print 'An error occurred: %s' % e\n```\n\n### Ruby\n\nUses the [Ruby client library](/glass/tools-downloads/client-libraries). \n\n```ruby\n##\n# Print information about all the known locations for the current user.\n#\n# @param [Google::APIClient] client\n# Authorized client instance.\n# @return nil\ndef print_all_locations(client)\n mirror = client.discovered_api('mirror', 'v1')\n result = client.execute(:api_method =\u003e mirror.locations.list)\n if result.success?\n locations = result.data\n locations.items.each do |location|\n puts \"Location recorded on: #{location.timestamp}\"\n puts \" \u003e Lat: #{location.latitude}\"\n puts \" \u003e Long: #{location.longitude}\"\n puts \" \u003e Accuracy: #{location.accuracy} meters\"\n end\n else\n puts \"An error occurred: #{result.data['error']['message']}\"\n end\nend\n```\n\n### Raw HTTP\n\nDoes not use a client library. \n\n```http\nGET /mirror/v1/locations HTTP/1.1\nHost: www.googleapis.com\nAuthorization: Bearer auth token\n```"]]