Place

public interface Place implements Freezable<Place>

Represents a particular physical place.

A Place encapsulates information about a physical location, including its name, address, and any other information we might have about it.

Note that generally some fields will be inapplicable to certain places, or the information may be unknown.

Constant Summary

int TYPE_ACCOUNTING
int TYPE_ADMINISTRATIVE_AREA_LEVEL_1
int TYPE_ADMINISTRATIVE_AREA_LEVEL_2
int TYPE_ADMINISTRATIVE_AREA_LEVEL_3
int TYPE_AIRPORT
int TYPE_AMUSEMENT_PARK
int TYPE_AQUARIUM
int TYPE_ART_GALLERY
int TYPE_ATM
int TYPE_BAKERY
int TYPE_BANK
int TYPE_BAR
int TYPE_BEAUTY_SALON
int TYPE_BICYCLE_STORE
int TYPE_BOOK_STORE
int TYPE_BOWLING_ALLEY
int TYPE_BUS_STATION
int TYPE_CAFE
int TYPE_CAMPGROUND
int TYPE_CAR_DEALER
int TYPE_CAR_RENTAL
int TYPE_CAR_REPAIR
int TYPE_CAR_WASH
int TYPE_CASINO
int TYPE_CEMETERY
int TYPE_CHURCH
int TYPE_CITY_HALL
int TYPE_CLOTHING_STORE
int TYPE_COLLOQUIAL_AREA
int TYPE_CONVENIENCE_STORE
int TYPE_COUNTRY
int TYPE_COURTHOUSE
int TYPE_DENTIST
int TYPE_DEPARTMENT_STORE
int TYPE_DOCTOR
int TYPE_ELECTRICIAN
int TYPE_ELECTRONICS_STORE
int TYPE_EMBASSY
int TYPE_ESTABLISHMENT
int TYPE_FINANCE
int TYPE_FIRE_STATION
int TYPE_FLOOR
int TYPE_FLORIST
int TYPE_FOOD
int TYPE_FUNERAL_HOME
int TYPE_FURNITURE_STORE
int TYPE_GAS_STATION
int TYPE_GENERAL_CONTRACTOR
int TYPE_GEOCODE
int TYPE_GROCERY_OR_SUPERMARKET
int TYPE_GYM
int TYPE_HAIR_CARE
int TYPE_HARDWARE_STORE
int TYPE_HEALTH
int TYPE_HINDU_TEMPLE
int TYPE_HOME_GOODS_STORE
int TYPE_HOSPITAL
int TYPE_INSURANCE_AGENCY
int TYPE_INTERSECTION
int TYPE_JEWELRY_STORE
int TYPE_LAUNDRY
int TYPE_LAWYER
int TYPE_LIBRARY
int TYPE_LIQUOR_STORE
int TYPE_LOCALITY
int TYPE_LOCAL_GOVERNMENT_OFFICE
int TYPE_LOCKSMITH
int TYPE_LODGING
int TYPE_MEAL_DELIVERY
int TYPE_MEAL_TAKEAWAY
int TYPE_MOSQUE
int TYPE_MOVIE_RENTAL
int TYPE_MOVIE_THEATER
int TYPE_MOVING_COMPANY
int TYPE_MUSEUM
int TYPE_NATURAL_FEATURE
int TYPE_NEIGHBORHOOD
int TYPE_NIGHT_CLUB
int TYPE_OTHER
int TYPE_PAINTER
int TYPE_PARK
int TYPE_PARKING
int TYPE_PET_STORE
int TYPE_PHARMACY
int TYPE_PHYSIOTHERAPIST
int TYPE_PLACE_OF_WORSHIP
int TYPE_PLUMBER
int TYPE_POINT_OF_INTEREST
int TYPE_POLICE
int TYPE_POLITICAL
int TYPE_POSTAL_CODE
int TYPE_POSTAL_CODE_PREFIX
int TYPE_POSTAL_TOWN
int TYPE_POST_BOX
int TYPE_POST_OFFICE
int TYPE_PREMISE
int TYPE_REAL_ESTATE_AGENCY
int TYPE_RESTAURANT
int TYPE_ROOFING_CONTRACTOR
int TYPE_ROOM
int TYPE_ROUTE
int TYPE_RV_PARK
int TYPE_SCHOOL
int TYPE_SHOE_STORE
int TYPE_SHOPPING_MALL
int TYPE_SPA
int TYPE_STADIUM
int TYPE_STORAGE
int TYPE_STORE
int TYPE_STREET_ADDRESS
int TYPE_SUBLOCALITY
int TYPE_SUBLOCALITY_LEVEL_1
int TYPE_SUBLOCALITY_LEVEL_2
int TYPE_SUBLOCALITY_LEVEL_3
int TYPE_SUBLOCALITY_LEVEL_4
int TYPE_SUBLOCALITY_LEVEL_5
int TYPE_SUBPREMISE
int TYPE_SUBWAY_STATION
int TYPE_SYNAGOGUE
int TYPE_SYNTHETIC_GEOCODE
int TYPE_TAXI_STAND
int TYPE_TRAIN_STATION
int TYPE_TRANSIT_STATION
int TYPE_TRAVEL_AGENCY
int TYPE_UNIVERSITY
int TYPE_VETERINARY_CARE
int TYPE_ZOO

Public Method Summary

abstract CharSequence
getAddress()
Returns a human readable address for this Place.
abstract CharSequence
getAttributions()
Returns the attributions to be shown to the user if data from the Place is used.
abstract String
getId()
Returns the unique id of this Place.
abstract LatLng
getLatLng()
Returns the location of this Place.
abstract Locale
getLocale()
Returns the locale in which the names and addresses were localized.
abstract CharSequence
getName()
Returns the name of this Place.
abstract CharSequence
getPhoneNumber()
Returns the place's phone number in international format.
abstract List<Integer>
getPlaceTypes()
Returns a list of place types for this Place.
abstract int
getPriceLevel()
Returns the price level for this place on a scale from 0 (cheapest) to 4.
abstract float
getRating()
Returns the place's rating, from 1.0 to 5.0, based on aggregated user reviews.
abstract LatLngBounds
getViewport()
Returns a viewport for displaying this Place.
abstract Uri
getWebsiteUri()
Returns the URI of the website of this Place.

Inherited Method Summary

Constants

public static final int TYPE_ACCOUNTING

Constant Value: 1

public static final int TYPE_ADMINISTRATIVE_AREA_LEVEL_1

Constant Value: 1001

public static final int TYPE_ADMINISTRATIVE_AREA_LEVEL_2

Constant Value: 1002

public static final int TYPE_ADMINISTRATIVE_AREA_LEVEL_3

Constant Value: 1003

public static final int TYPE_AIRPORT

Constant Value: 2

public static final int TYPE_AMUSEMENT_PARK

Constant Value: 3

public static final int TYPE_AQUARIUM

Constant Value: 4

public static final int TYPE_ART_GALLERY

Constant Value: 5

public static final int TYPE_ATM

Constant Value: 6

public static final int TYPE_BAKERY

Constant Value: 7

public static final int TYPE_BANK

Constant Value: 8

public static final int TYPE_BAR

Constant Value: 9

public static final int TYPE_BEAUTY_SALON

Constant Value: 10

public static final int TYPE_BICYCLE_STORE

Constant Value: 11

public static final int TYPE_BOOK_STORE

Constant Value: 12

public static final int TYPE_BOWLING_ALLEY

Constant Value: 13

public static final int TYPE_BUS_STATION

Constant Value: 14

public static final int TYPE_CAFE

Constant Value: 15

public static final int TYPE_CAMPGROUND

Constant Value: 16

public static final int TYPE_CAR_DEALER

Constant Value: 17

public static final int TYPE_CAR_RENTAL

Constant Value: 18

public static final int TYPE_CAR_REPAIR

Constant Value: 19

public static final int TYPE_CAR_WASH

Constant Value: 20

public static final int TYPE_CASINO

Constant Value: 21

public static final int TYPE_CEMETERY

Constant Value: 22

public static final int TYPE_CHURCH

Constant Value: 23

public static final int TYPE_CITY_HALL

Constant Value: 24

public static final int TYPE_CLOTHING_STORE

Constant Value: 25

public static final int TYPE_COLLOQUIAL_AREA

Constant Value: 1004

public static final int TYPE_CONVENIENCE_STORE

Constant Value: 26

public static final int TYPE_COUNTRY

Constant Value: 1005

public static final int TYPE_COURTHOUSE

Constant Value: 27

public static final int TYPE_DENTIST

Constant Value: 28

public static final int TYPE_DEPARTMENT_STORE

Constant Value: 29

public static final int TYPE_DOCTOR

Constant Value: 30

public static final int TYPE_ELECTRICIAN

Constant Value: 31

public static final int TYPE_ELECTRONICS_STORE

Constant Value: 32

public static final int TYPE_EMBASSY

Constant Value: 33

public static final int TYPE_ESTABLISHMENT

Constant Value: 34

public static final int TYPE_FINANCE

Constant Value: 35

public static final int TYPE_FIRE_STATION

Constant Value: 36

public static final int TYPE_FLOOR

Constant Value: 1006

public static final int TYPE_FLORIST

Constant Value: 37

public static final int TYPE_FOOD

Constant Value: 38

public static final int TYPE_FUNERAL_HOME

Constant Value: 39

public static final int TYPE_FURNITURE_STORE

Constant Value: 40

public static final int TYPE_GAS_STATION

Constant Value: 41

public static final int TYPE_GENERAL_CONTRACTOR

Constant Value: 42

public static final int TYPE_GEOCODE

Constant Value: 1007

public static final int TYPE_GROCERY_OR_SUPERMARKET

Constant Value: 43

public static final int TYPE_GYM

Constant Value: 44

public static final int TYPE_HAIR_CARE

Constant Value: 45

public static final int TYPE_HARDWARE_STORE

Constant Value: 46

public static final int TYPE_HEALTH

Constant Value: 47

public static final int TYPE_HINDU_TEMPLE

Constant Value: 48

public static final int TYPE_HOME_GOODS_STORE

Constant Value: 49

public static final int TYPE_HOSPITAL

Constant Value: 50

public static final int TYPE_INSURANCE_AGENCY

Constant Value: 51

public static final int TYPE_INTERSECTION

Constant Value: 1008

public static final int TYPE_JEWELRY_STORE

Constant Value: 52

public static final int TYPE_LAUNDRY

Constant Value: 53

public static final int TYPE_LAWYER

Constant Value: 54

public static final int TYPE_LIBRARY

Constant Value: 55

public static final int TYPE_LIQUOR_STORE

Constant Value: 56

public static final int TYPE_LOCALITY

Constant Value: 1009

public static final int TYPE_LOCAL_GOVERNMENT_OFFICE

Constant Value: 57

public static final int TYPE_LOCKSMITH

Constant Value: 58

public static final int TYPE_LODGING

Constant Value: 59

public static final int TYPE_MEAL_DELIVERY

Constant Value: 60

public static final int TYPE_MEAL_TAKEAWAY

Constant Value: 61

public static final int TYPE_MOSQUE

Constant Value: 62

public static final int TYPE_MOVIE_RENTAL

Constant Value: 63

public static final int TYPE_MOVIE_THEATER

Constant Value: 64

public static final int TYPE_MOVING_COMPANY

Constant Value: 65

public static final int TYPE_MUSEUM

Constant Value: 66

public static final int TYPE_NATURAL_FEATURE

Constant Value: 1010

public static final int TYPE_NEIGHBORHOOD

Constant Value: 1011

public static final int TYPE_NIGHT_CLUB

Constant Value: 67

public static final int TYPE_OTHER

Constant Value: 0

public static final int TYPE_PAINTER

Constant Value: 68

public static final int TYPE_PARK

Constant Value: 69

public static final int TYPE_PARKING

Constant Value: 70

public static final int TYPE_PET_STORE

Constant Value: 71

public static final int TYPE_PHARMACY

Constant Value: 72

public static final int TYPE_PHYSIOTHERAPIST

Constant Value: 73

public static final int TYPE_PLACE_OF_WORSHIP

Constant Value: 74

public static final int TYPE_PLUMBER

Constant Value: 75

public static final int TYPE_POINT_OF_INTEREST

Constant Value: 1013

public static final int TYPE_POLICE

Constant Value: 76

public static final int TYPE_POLITICAL

Constant Value: 1012

public static final int TYPE_POSTAL_CODE

Constant Value: 1015

public static final int TYPE_POSTAL_CODE_PREFIX

Constant Value: 1016

public static final int TYPE_POSTAL_TOWN

Constant Value: 1017

public static final int TYPE_POST_BOX

Constant Value: 1014

public static final int TYPE_POST_OFFICE

Constant Value: 77

public static final int TYPE_PREMISE

Constant Value: 1018

public static final int TYPE_REAL_ESTATE_AGENCY

Constant Value: 78

public static final int TYPE_RESTAURANT

Constant Value: 79

public static final int TYPE_ROOFING_CONTRACTOR

Constant Value: 80

public static final int TYPE_ROOM

Constant Value: 1019

public static final int TYPE_ROUTE

Constant Value: 1020

public static final int TYPE_RV_PARK

Constant Value: 81

public static final int TYPE_SCHOOL

Constant Value: 82

public static final int TYPE_SHOE_STORE

Constant Value: 83

public static final int TYPE_SHOPPING_MALL

Constant Value: 84

public static final int TYPE_SPA

Constant Value: 85

public static final int TYPE_STADIUM

Constant Value: 86

public static final int TYPE_STORAGE

Constant Value: 87

public static final int TYPE_STORE

Constant Value: 88

public static final int TYPE_STREET_ADDRESS

Constant Value: 1021

public static final int TYPE_SUBLOCALITY

Constant Value: 1022

public static final int TYPE_SUBLOCALITY_LEVEL_1

Constant Value: 1023

public static final int TYPE_SUBLOCALITY_LEVEL_2

Constant Value: 1024

public static final int TYPE_SUBLOCALITY_LEVEL_3

Constant Value: 1025

public static final int TYPE_SUBLOCALITY_LEVEL_4

Constant Value: 1026

public static final int TYPE_SUBLOCALITY_LEVEL_5

Constant Value: 1027

public static final int TYPE_SUBPREMISE

Constant Value: 1028

public static final int TYPE_SUBWAY_STATION

Constant Value: 89

public static final int TYPE_SYNAGOGUE

Constant Value: 90

public static final int TYPE_SYNTHETIC_GEOCODE

Constant Value: 1029

public static final int TYPE_TAXI_STAND

Constant Value: 91

public static final int TYPE_TRAIN_STATION

Constant Value: 92

public static final int TYPE_TRANSIT_STATION

Constant Value: 1030

public static final int TYPE_TRAVEL_AGENCY

Constant Value: 93

public static final int TYPE_UNIVERSITY

Constant Value: 94

public static final int TYPE_VETERINARY_CARE

Constant Value: 95

public static final int TYPE_ZOO

Constant Value: 96

Public Methods

public abstract CharSequence getAddress ()

Returns a human readable address for this Place. May return null if the address is unknown.

The address is localized according to the locale returned by getLocale().

public abstract CharSequence getAttributions ()

Returns the attributions to be shown to the user if data from the Place is used.

We recommend placing this information below any place information. See Displaying Attributions for more details.

Returns
  • The attributions in HTML format, or null if there are no attributions to display.

public abstract String getId ()

Returns the unique id of this Place.

This ID can be passed to getPlaceById(GoogleApiClient, String...) to lookup the same place at a later time, but it is not guaranteed that such a lookup will succeed (the place may no longer exist in our database). It is possible that the returned Place in such a lookup will have a different ID (so there may be multiple ID's for one given place).

public abstract LatLng getLatLng ()

Returns the location of this Place.

The location is not necessarily the center of the Place, or any particular entry or exit point, but some arbitrarily chosen point within the geographic extent of the Place.

public abstract Locale getLocale ()

Returns the locale in which the names and addresses were localized.

public abstract CharSequence getName ()

Returns the name of this Place.

The name is localized according to the locale returned by getLocale().

public abstract CharSequence getPhoneNumber ()

Returns the place's phone number in international format. Returns null if no phone number is known, or the place has no phone number.

International format includes the country code, and is prefixed with the plus (+) sign. For example, the international phone number for Google's Mountain View, USA office is +1 650-253-0000.

public abstract List<Integer> getPlaceTypes ()

Returns a list of place types for this Place.

The elements of this list are drawn from Place.TYPE_* constants, though one should expect there could be new place types returned that were introduced after an app was published.

public abstract int getPriceLevel ()

Returns the price level for this place on a scale from 0 (cheapest) to 4.

If no price level is known, a negative value is returned.

The price level of the place, on a scale of 0 to 4. The exact amount indicated by a specific value will vary from region to region. Price levels are interpreted as follows:

  • 0 — Free
  • 1 — Inexpensive
  • 2 — Moderate
  • 3 — Expensive
  • 4 — Very Expensive

public abstract float getRating ()

Returns the place's rating, from 1.0 to 5.0, based on aggregated user reviews.

If no rating is known, a negative value is returned.

public abstract LatLngBounds getViewport ()

Returns a viewport for displaying this Place. May return null if the size of the place is not known.

This returns a viewport of a size that is suitable for displaying this Place. For example, a Place representing a store may have a relatively small viewport, while a Place representing a country may have a very large viewport.

public abstract Uri getWebsiteUri ()

Returns the URI of the website of this Place. Returns null if no website is known.

This is the URI of the website maintained by the Place, if available. Note this is a third-party website not affiliated with the Places API.