Package com.google.maps

Class FindPlaceFromTextRequest

java.lang.Object

com.google.maps.FindPlaceFromTextRequest

All Implemented Interfaces:

PendingResult<FindPlaceFromText>

public class FindPlaceFromTextRequest
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FindPlaceFromTextRequest.FieldMask
static class	FindPlaceFromTextRequest.InputType
static interface	FindPlaceFromTextRequest.LocationBias
static class	FindPlaceFromTextRequest.LocationBiasCircular
static class	FindPlaceFromTextRequest.LocationBiasIP
static class	FindPlaceFromTextRequest.LocationBiasPoint
static class	FindPlaceFromTextRequest.LocationBiasRectangular
static class	FindPlaceFromTextRequest.Response

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

PendingResult.Callback<T>

Constructor Summary

Constructors

Constructor	Description
FindPlaceFromTextRequest(GeoApiContext context)

Method Summary

Modifier and Type	Method	Description
T	await()	Performs the request synchronously.
T	awaitIgnoreError()	Performs the request synchronously, ignoring exceptions while performing the request and errors returned by the server.
void	cancel()	Attempts to cancel the request.
A	channel(java.lang.String channel)	A channel to pass with the request.
A	custom(java.lang.String parameter, java.lang.String value)	Custom parameter.
A	experienceIds(java.lang.String... experienceIds)	Sets the value for the HTTP header field name HttpHeaders.X_GOOG_MAPS_EXPERIENCE_ID.
FindPlaceFromTextRequest	fields(FindPlaceFromTextRequest.FieldMask... fields)	The fields specifying the types of place data to return.
A	header(java.lang.String key, java.lang.String value)	Sets the header named key to value.
FindPlaceFromTextRequest	input(java.lang.String input)	The text input specifying which place to search for (for example, a name, address, or phone number).
FindPlaceFromTextRequest	inputType(FindPlaceFromTextRequest.InputType inputType)	The type of input.
A	language(java.lang.String language)	The language in which to return results.
FindPlaceFromTextRequest	locationBias(FindPlaceFromTextRequest.LocationBias locationBias)	Prefer results in a specified area, by specifying either a radius plus lat/lng, or two lat/lng pairs representing the points of a rectangle.
protected A	param(java.lang.String key, int val)
protected A	param(java.lang.String key, com.google.maps.internal.StringJoin.UrlValue val)
protected A	param(java.lang.String key, java.lang.String val)
protected A	paramAddToList(java.lang.String key, com.google.maps.internal.StringJoin.UrlValue val)
protected A	paramAddToList(java.lang.String key, java.lang.String val)
protected java.util.Map<java.lang.String,java.util.List<java.lang.String>>	params()
void	setCallback(PendingResult.Callback<T> callback)	Performs the request asynchronously, calling onResult or onFailure after the request has been completed.
protected void	validateRequest()

Methods inherited from class java.lang.Object

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

Constructor Detail

FindPlaceFromTextRequest

public FindPlaceFromTextRequest(GeoApiContext context)

Method Detail

input

public FindPlaceFromTextRequest input(java.lang.String input)

The text input specifying which place to search for (for example, a name, address, or phone number).

Parameters:

input - The text input.

Returns:

Returns FindPlaceFromTextRequest for call chaining.

inputType

public FindPlaceFromTextRequest inputType(FindPlaceFromTextRequest.InputType inputType)

The type of input.

Parameters:

inputType - The input type.

Returns:

Returns FindPlaceFromTextRequest for call chaining.

fields

public FindPlaceFromTextRequest fields(FindPlaceFromTextRequest.FieldMask... fields)

The fields specifying the types of place data to return.

Parameters:

fields - The fields to return.

Returns:

Returns FindPlaceFromTextRequest for call chaining.

locationBias

public FindPlaceFromTextRequest locationBias(FindPlaceFromTextRequest.LocationBias locationBias)

Prefer results in a specified area, by specifying either a radius plus lat/lng, or two lat/lng pairs representing the points of a rectangle.

Parameters:

locationBias - The location bias for this request.

Returns:

Returns FindPlaceFromTextRequest for call chaining.

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>

Parameters:

callback - The callback to call on completion.

await

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

Description copied from interface: PendingResult

Performs the request synchronously.

Specified by:

await in interface PendingResult<T>

Returns:

The result.

Throws:

ApiException - Thrown if the API Returned result is an error.

java.lang.InterruptedException - Thrown when a thread is waiting, sleeping, or otherwise occupied, and the thread is interrupted.

java.io.IOException - Thrown when an I/O exception of some sort has occurred.

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

Attempts to cancel the request.

Specified by:

cancel in interface PendingResult<T>

header

public A header(java.lang.String key,
                java.lang.String value)

Sets the header named key to value. If this request already has any headers with the same key, the value is replaced.

Parameters:

key - the header key

value - the header value

Returns:

this request

experienceIds

public A experienceIds(java.lang.String... experienceIds)

Sets the value for the HTTP header field name HttpHeaders.X_GOOG_MAPS_EXPERIENCE_ID. Passing null to this method will unset the experienceId header field.

Parameters:

experienceIds - The experience IDs

param

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

param

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

param

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

paramAddToList

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

paramAddToList

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

params

protected java.util.Map<java.lang.String,java.util.List<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".

Returns:

Returns the request for call chaining.

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 Premium Plan Usage Rates and Limits.

Parameters:

channel - String to pass with the request for analytics.

Returns:

Returns the request for call chaining.

custom

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

Custom parameter. For advanced usage only.

Parameters:

parameter - The name of the custom parameter.

value - The value of the custom parameter.

Returns:

Returns the request for call chaining.