PlaceDetectionApi | Android Developers

Quicknav Quicknav
Links

- Google Play Developer Console
- Android Developers Blog
- About Android

Android Sites

- Android.com
- Android Developers
- Android Open Source Project

Language
close

- - About
  - Wear
  - TV
  - Auto
- - Get Started
  - Devices
  - Style
  - Patterns
  - Building Blocks
  - Downloads
  - Videos
- - Training
  - API Guides
  - Reference
  - Tools
  - Google Services
  - Samples
- - Google Play
  - Essentials
  - Get Users
  - Engage & Retain
  - Monetize
  - Analyze
  - Tools & Reference
  - Developer Stories

## Results

Loading...
public interface

# PlaceDetectionApi

com.google.android.gms.location.places.PlaceDetectionApi

## Class Overview

Main entry point for the Google Place Detection API.

The Place Detection API provides quick access to the device's current place, and offers the opportunity to report the location of the device at a particular place (like a check in).

Some methods of the PlaceDetectionAPI are subject to a quota limit, as mentioned in the description of the methods concerned.

See `PlacesStatusCodes` for detailed information about the error codes.

## Summary

Public Methods
abstract PendingResult<PlaceLikelihoodBuffer> | getCurrentPlace(GoogleApiClient client, PlaceFilter filter) Returns an estimate of the place where the device is currently known to be located.
abstract PendingResult<Status> | reportDeviceAtPlace(GoogleApiClient client, PlaceReport report) Report that the device is currently at a particular place.

## Public Methods

#### public abstract PendingResult<PlaceLikelihoodBuffer> getCurrentPlace (GoogleApiClient client, PlaceFilter filter)

Returns an estimate of the place where the device is currently known to be located.

Generates a PlaceLikelihoodBuffer based on the device's last estimated location. Only places which match the given filter will be returned. If the filter requests only coarse place types, results may be obtained at lower latency and power cost, especially over repeated calls.

The returned values may be obtained by means of a network lookup. The results are a best guess and are not guaranteed to be meaningful or correct.

This API requires the calling application to have the `ACCESS_FINE_LOCATION` permission.

Access to this method is subject to quota restrictions.

##### Parameters

filter | filtering criteria for the results. If the filter is null, then default filtering parameters are used (see `PlaceFilter`)

##### Returns

- the PlaceLikelihoodBuffer, which may be empty if the place or location is not known or does not match the filtering criteria

#### public abstract PendingResult<Status> reportDeviceAtPlace (GoogleApiClient client, PlaceReport report)

Report that the device is currently at a particular place.

##### Parameters

report | to be uploaded to the server.