com.google.maps

Class PlaceAutocompleteRequest

java.lang.Object

com.google.maps.PlaceAutocompleteRequest

All Implemented Interfaces:

PendingResult<AutocompletePrediction[]>

public class PlaceAutocompleteRequest
extends java.lang.Object

A Place Autocomplete request.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PlaceAutocompleteRequest.Response

Nested classes/interfaces inherited from interface com.google.maps.PendingResult

PendingResult.Callback<T>

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PlaceAutocompleteRequest(GeoApiContext context)

Method Summary

Modifier and Type	Method and Description
T	await() Performs the GET request synchronously.
T	awaitIgnoreError() Performs the request synchronously, ignoring exceptions while performing the request and errors returned by the server.
void	cancel() Attempt to cancel the request.
A	channel(java.lang.String channel) A channel to pass with the request.
PlaceAutocompleteRequest	components(ComponentFilter... filters) Components is a grouping of places to which you would like to restrict your results.
A	custom(java.lang.String parameter, java.lang.String value) Custom parameter.
PlaceAutocompleteRequest	input(java.lang.String input) input is the text string on which to search.
A	language(java.lang.String language) The language in which to return results.
PlaceAutocompleteRequest	location(LatLng location) location is the point around which you wish to retrieve place information.
PlaceAutocompleteRequest	offset(int offset) offset is the character position in the input term at which the service uses text for predictions.
protected A	param(java.lang.String key, java.lang.String val)
protected A	param(java.lang.String key, com.google.maps.internal.StringJoin.UrlValue val)
protected java.util.Map<java.lang.String,java.lang.String>	params()
PlaceAutocompleteRequest	radius(int radius) radius is the distance (in meters) within which to return place results.
void	setCallback(PendingResult.Callback<T> callback) Performs the request asynchronously, calling onResult or onFailure after the request has been completed.
PlaceAutocompleteRequest	type(PlaceAutocompleteType type) type restricts the results to places matching the specified type.
protected void	validateRequest()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PlaceAutocompleteRequest

protected PlaceAutocompleteRequest(GeoApiContext context)

Method Detail

input

public PlaceAutocompleteRequest input(java.lang.String input)

input is the text string on which to search. The Places service will return candidate matches based on this string and order results based on their perceived relevance.

offset

public PlaceAutocompleteRequest offset(int offset)

offset is the character position in the input term at which the service uses text for predictions. For example, if the input is 'Googl' and the completion point is 3, the service will match on 'Goo'. The offset should generally be set to the position of the text caret. If no offset is supplied, the service will use the entire term.

location

public PlaceAutocompleteRequest location(LatLng location)

location is the point around which you wish to retrieve place information.

radius

public PlaceAutocompleteRequest radius(int radius)

radius is the distance (in meters) within which to return place results. Note that setting a radius biases results to the indicated area, but may not fully restrict results to the specified area.

type

public PlaceAutocompleteRequest type(PlaceAutocompleteType type)

type restricts the results to places matching the specified type.

components

public PlaceAutocompleteRequest components(ComponentFilter... filters)

Components is a grouping of places to which you would like to restrict your results. Currently, you can use components to filter by country.

validateRequest

protected void validateRequest()

setCallback

public final void setCallback(PendingResult.Callback<T> callback)

Description copied from interface: PendingResult

Performs the request asynchronously, calling onResult or onFailure after the request has been completed.

Specified by:

setCallback in interface PendingResult<T>

await

public final T await()
              throws ApiException,
                     java.lang.InterruptedException,
                     java.io.IOException

Description copied from interface: PendingResult

Performs the GET request synchronously.

Specified by:

await in interface PendingResult<T>

Returns:

The result.

Throws:

ApiException

java.lang.InterruptedException

java.io.IOException

awaitIgnoreError

public final T awaitIgnoreError()

Description copied from interface: PendingResult

Performs the request synchronously, ignoring exceptions while performing the request and errors returned by the server.

Specified by:

awaitIgnoreError in interface PendingResult<T>

Returns:

The result, or null if there was any error or exception ignored.

cancel

public final void cancel()

Description copied from interface: PendingResult

Attempt to cancel the request.

Specified by:

cancel in interface PendingResult<T>

param

protected A param(java.lang.String key,
                  java.lang.String val)

param

protected A param(java.lang.String key,
                  com.google.maps.internal.StringJoin.UrlValue val)

params

protected java.util.Map<java.lang.String,java.lang.String> params()

language

public final A language(java.lang.String language)

The language in which to return results. Note that we often update supported languages so this list may not be exhaustive.

Parameters:

language - The language code, e.g. "en-AU" or "es"

See Also:

List of supported domain languages

channel

public A channel(java.lang.String channel)

A channel to pass with the request. channel is used by Google Maps API for Work users to be able to track usage across different applications with the same clientID. See: https://developers.google.com/maps/documentation/business/clientside/quota

Parameters:

channel - String to pass with the request for analytics

custom

public A custom(java.lang.String parameter,
                java.lang.String value)

Custom parameter. For advanced usage only. Note: Using this escape hatch parameter pass though voids all warranties, only use in extreme circumstances.