Find Place (舊版)

When the service returns a status code other than OK<, there may be an additional error_message field within the response object. This field contains more detailed information about thereasons behind the given status code. This field is not always returned, and its content is subject to change.

When the service returns additional information about the request specification, there may be an additional info_messages field within the response object. This field is only returned for successful requests. It may not always be returned, and its content is subject to change.

A representation of the place's address in the adr microformat.

Indicates the operational status of the place, if it is a business. If no data exists, business_status is not returned.

Specifies if the business supports curbside pickup.

Specifies if the business supports delivery.

Specifies if the business supports indoor or outdoor seating options.

A string containing the human-readable address of this place.

Often this address is equivalent to the postal address. Note that some countries, such as the United Kingdom, do not allow distribution of true postal addresses due to licensing restrictions.

The formatted address is logically composed of one or more address components. For example, the address "111 8th Avenue, New York, NY" consists of the following components: "111" (the street number), "8th Avenue" (the route), "New York" (the city) and "NY" (the US state).

Do not parse the formatted address programmatically. Instead you should use the individual address components, which the API response includes in addition to the formatted address field.

Contains the place's phone number in its local format.

Contains the URL of a suggested icon which may be displayed to the user when indicating this result on a map.

Contains the default HEX color code for the place's category.

Contains the URL of a recommended icon, minus the .svg or .png file type extension.

Contains the place's phone number in international format. International format includes the country code, and is prefixed with the plus, +, sign. For example, the international_phone_number for Google's Sydney, Australia office is +61 2 9374 4000.

Contains the human-readable name for the returned result. For establishment results, this is usually the canonicalized business name.

Use business_status to get the operational status of businesses.

A textual identifier that uniquely identifies a place. To retrieve information about the place, pass this identifier in the place_id field of a Places API request. For more information about place IDs, see the place ID overview.

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

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

Specifies if the place supports reservations.

Specifies if the place serves beer.

Specifies if the place serves breakfast.

Specifies if the place serves brunch.

Specifies if the place serves dinner.

Specifies if the place serves lunch.

Specifies if the place serves vegetarian food.

Specifies if the place serves wine.

Specifies if the business supports takeout.

Contains an array of feature types describing the given result. See the list of supported types.

Contains the URL of the official Google page for this place. This will be the Google-owned page that contains the best available information about the place. Applications must link to or embed this page on any screen that shows detailed results about the place to the user.

The total number of reviews, with or without text, for this place.

Contains the number of minutes this place’s current timezone is offset from UTC. For example, for places in Sydney, Australia during daylight saving time this would be 660 (+11 hours from UTC), and for places in California outside of daylight saving time this would be -480 (-8 hours from UTC).

For establishment (types:["establishment", ...]) results only, the vicinity field contains a simplified address for the place, including the street name, street number, and locality, but not the province/state, postal code, or country.

For all other results, the vicinity field contains the name of the narrowest political (types:["political", ...]) feature that is present in the address of the result.

This content is meant to be read as-is. Do not programmatically parse the formatted address.

The authoritative website for this place, such as a business' homepage.

Specifies if the place has an entrance that is wheelchair-accessible.

The full text description or name of the address component as returned by the Geocoder.

An abbreviated textual name for the address component, if available. For example, an address component for the state of Alaska may have a long_name of "Alaska" and a short_name of "AK" using the 2-letter postal abbreviation.

An array indicating the type of the address component. See the list of supported types.

The language of the previous fields. May not always be present.

A medium-length textual summary of the place.

Latitude in decimal degrees

Longitude in decimal degrees

A boolean value indicating if the place is open at the current time.

A type string used to identify the type of secondary hours (for example, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Set for secondary_opening_hours only.

An array of strings describing in human-readable text the hours of the place.

A date expressed in RFC3339 format in the local timezone for the place, for example 2010-12-31.

True if there are exceptional hours for this day. If true, this means that there is at least one exception for this day. Exceptions cause different values to occur in the subfields of current_opening_hours and secondary_opening_hours such as periods, weekday_text, open_now. The exceptions apply to the hours, and the hours are used to generate the other fields.

A number from 0–6, corresponding to the days of the week, starting on Sunday. For example, 2 means Tuesday.

May contain a time of day in 24-hour hhmm format. Values are in the range 0000–2359. The time will be reported in the place’s time zone.

A date expressed in RFC3339 format in the local timezone for the place, for example 2010-12-31.

True if a given period was truncated due to a seven-day cutoff, where the period starts before midnight on the date of the request and/or ends at or after midnight on the last day. This property indicates that the period for open or close can extend past this seven-day cutoff.

The height of the photo.

The HTML attributions for the photo.

A string used to identify the photo when you perform a Photo request.

The width of the photo.

The global_code is a 4 character area code and 6 character or longer local code (849VCWC8+R9).

The compound_code is a 6 character or longer local code with an explicit location (CWC8+R9, Mountain View, CA, USA). Some APIs may return an empty string if the compound_code is not available.

The name of the user who submitted the review. Anonymous reviews are attributed to "A Google user".

The user's overall rating for this place. This is a whole number, ranging from 1 to 5.

The time that the review was submitted in text, relative to the current time.

The time that the review was submitted, measured in the number of seconds since since midnight, January 1, 1970 UTC.

The URL to the user's Google Maps Local Guides profile, if available.

An IETF language code indicating the language of the returned review.This field contains the main language tag only, and not the secondary tag indicating country or region. For example, all the English reviews are tagged as 'en', and not 'en-AU' or 'en-UK' and so on.This field is empty if there is only a rating with no review text.

An IETF language code indicating the original language of the review. If the review has been translated, then original_language != language.This field contains the main language tag only, and not the secondary tag indicating country or region. For example, all the English reviews are tagged as 'en', and not 'en-AU' or 'en-UK' and so on.This field is empty if there is only a rating with no review text.

The URL to the user's profile photo, if available.

The user's review. When reviewing a location with Google Places, text reviews are considered optional. Therefore, this field may be empty. Note that this field may include simple HTML markup. For example, the entity reference & may represent an ampersand character.

A boolean value indicating if the review was translated from the original language it was written in.If a review has been translated, corresponding to a value of true, Google recommends that you indicate this to your users. For example, you can add the following string, “Translated by Google”, to the review.