Courtesy: GitHub

Basic Location Sample

Demonstrates use of the Google Play services Location API to retrieve the last known location for a device.

Introduction

This sample shows a simple way of getting a device's last known location, which is usually equivalent to the device's current location. The accuracy of the location returned is based on the location permissions you've requested and the location sensors that are currently active for the device.

To run this sample, location must be enabled.

This sample uses [FusedLocationProviderClient] (https://developer.android.com/reference/com/google/android/gms/location/LocationServices.html).

To run this sample, location must be enabled.

Prerequisites

  • Android API Level >v9
  • Android Build Tools >v21
  • Google Support Repository

Getting Started

This sample uses the Gradle build system. To build this project, use the "gradlew build" command or use "Import Project" in Android Studio.

Support

If you've found an error in this sample, please file an issue: https://github.com/googlesamples/android-play-location/issues

Patches are encouraged, and may be submitted according to the instructions in CONTRIBUTING.md.

License

Copyright 2014 Google, Inc.

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

compileSdkVersion 25

applicationId "com.google.android.gms.location.sample.basiclocationsample"

minSdkVersion 16

targetSdkVersion 25

versionCode 1

versionName "1.0"

compile fileTree(dir: 'libs', include: ['*.jar'])

compile 'com.android.support:appcompat-v7:25.3.1'

testCompile 'junit:junit:4.12'

compile 'com.android.support:design:25.3.1'

compile 'com.google.android.gms:play-services-location:11.0.0'

package com.google.android.gms.location.sample.basiclocationsample

uses-permission

  • android.permission.ACCESS_COARSE_LOCATION

MainActivity

Location sample.

Demonstrates use of the Location API to retrieve the last known location for a device.

Provides the entry point to the Fused Location Provider API.

Represents a geographical location.

Provides a simple way of getting a device's location and is well suited for applications that do not require a fine-grained location and that do not need location updates. Gets the best and most recent location currently available, which may be null in rare cases when a location is not available.

Note: this method should be called after location permission has been granted.

Shows a {@link Snackbar} using {@code text}. * @param text The Snackbar text.

Shows a {@link Snackbar}. * @param mainTextStringId The id for the string resource for the Snackbar text. @param actionStringId The text of the action item. @param listener The listener associated with the Snackbar action.

Return the current state of the permissions needed.

Callback received when a permissions request has been completed.