REST Resource: places

Tài nguyên: Địa điểm

Tất cả thông tin đại diện cho một Địa điểm.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  }
}
Trường
name

string

Tên tài nguyên của địa điểm này, ở định dạng places/{placeId}. Có thể được sử dụng để tra cứu Địa điểm.
id

string

Giá trị nhận dạng duy nhất của một địa điểm.
displayName

object (LocalizedText)

Tên được bản địa hoá của địa điểm, phù hợp với một bản mô tả ngắn mà con người có thể đọc được. Ví dụ: "Google Sydney", " mượt mà", "Pyrmont", v.v.
types[]

string

Một tập hợp thẻ loại cho kết quả này. Ví dụ: "chính trị" và "địa phương". Để xem danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types
primaryType

string

Loại chính của kết quả đã cho. Loại này phải là một trong các loại được hỗ trợ Places API. Ví dụ: "nhà hàng", "quán cà phê", "sân bay", v.v. Một địa điểm chỉ có thể có một loại chính duy nhất. Để xem danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types
primaryTypeDisplayName

object (LocalizedText)

Tên hiển thị của loại chính, được bản địa hoá sang ngôn ngữ yêu cầu (nếu có). Để xem danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types
nationalPhoneNumber

string

Số điện thoại mà con người có thể đọc được của địa điểm, ở định dạng quốc gia.
internationalPhoneNumber

string

Số điện thoại mà con người có thể đọc được của địa điểm, ở định dạng quốc tế.
formattedAddress

string

Địa chỉ đầy đủ, con người có thể đọc được cho địa điểm này.
shortFormattedAddress

string

Địa chỉ ngắn, mà con người có thể đọc được cho địa điểm này.
addressComponents[]

object (AddressComponent)

Các thành phần được lặp lại cho từng cấp tổ dân phố. Hãy lưu ý các thông tin sau về mảng addressComponents[]: – Mảng thành phần địa chỉ có thể chứa nhiều thành phần hơn so với FormatAddress. - Mảng này không nhất thiết bao gồm tất cả pháp nhân chính trị có chứa địa chỉ, ngoài những pháp nhân có trong FormatAddress. Để truy xuất tất cả các pháp nhân chính trị có chứa một địa chỉ cụ thể, bạn phải sử dụng mã hóa địa lý ngược, chuyển vĩ độ/kinh độ của địa chỉ dưới dạng tham số tới yêu cầu. – Định dạng của phản hồi không được đảm bảo giống nhau giữa các yêu cầu. Cụ thể, số lượng addressComponents thay đổi dựa trên địa chỉ được yêu cầu và có thể thay đổi theo thời gian đối với cùng một địa chỉ. Một thành phần có thể thay đổi vị trí trong mảng. Loại của thành phần có thể thay đổi. Một thành phần cụ thể có thể bị thiếu trong phản hồi sau đó.
plusCode

object (PlusCode)

Mã cộng của vị trí địa điểm vĩ độ/kinh độ.
location

object (LatLng)

Vị trí của địa điểm này.
viewport

object (Viewport)

Chế độ xem thích hợp để hiển thị địa điểm trên bản đồ có kích thước trung bình.
rating

number

Điểm xếp hạng từ 1.0 đến 5.0, dựa trên đánh giá của người dùng về địa điểm này.
googleMapsUri

string

URL cung cấp thêm thông tin về địa điểm này.
websiteUri

string

Trang web có thẩm quyền của địa điểm này, ví dụ: trang chủ của một doanh nghiệp. Xin lưu ý rằng đối với những địa điểm thuộc một chuỗi (ví dụ: cửa hàng IKEA), đây thường là trang web của từng cửa hàng riêng lẻ, chứ không phải toàn bộ chuỗi.
reviews[]

object (Review)

Danh sách các bài đánh giá về địa điểm này, được sắp xếp theo mức độ liên quan. Bạn có thể trả về tối đa 5 bài đánh giá.
regularOpeningHours

object (OpeningHours)

Giờ làm việc thông thường.
photos[]

object (Photo)

Thông tin (bao gồm cả tài liệu tham khảo) về hình ảnh của địa điểm này. Bạn có thể trả lại tối đa 10 ảnh.
adrFormatAddress

string

Địa chỉ của địa điểm ở vi định dạng quảng cáo: http://microformats.org/wiki/adr.
businessStatus

enum (BusinessStatus)

Trạng thái doanh nghiệp của địa điểm.
priceLevel

enum (PriceLevel)

Mức giá của địa điểm.
attributions[]

object (Attribution)

Một tập hợp nhà cung cấp dữ liệu phải được hiển thị cùng với kết quả này.
iconMaskBaseUri

string

URL bị cắt bớt đến một mặt nạ biểu tượng. Người dùng có thể truy cập vào nhiều loại biểu tượng bằng cách thêm hậu tố loại vào cuối (ví dụ: ".svg" hoặc ".png").
iconBackgroundColor

string

Màu nền cho icon_mask ở định dạng hex, ví dụ: #909CE1.
currentOpeningHours

object (OpeningHours)

Giờ làm việc trong 7 ngày tiếp theo (bao gồm cả hôm nay). Khoảng thời gian này bắt đầu lúc nửa đêm ngày yêu cầu và kết thúc lúc 23:59 tối sáu ngày sau đó. Trường này bao gồm trường phụ là Ngày đặc biệt của tất cả các giờ, được đặt cho những ngày có giờ đặc biệt.
currentSecondaryOpeningHours[]

object (OpeningHours)

Chứa một loạt các mục cho bảy ngày tiếp theo, bao gồm cả thông tin về giờ phụ của một doanh nghiệp. Giờ phụ khác với giờ chính của doanh nghiệp. Ví dụ: nhà hàng có thể chỉ định giờ mua hàng trên xe hoặc giờ giao hàng làm giờ phụ. Trường này điền sẵn trường con loại. Trường này lấy từ danh sách các loại giờ mở cửa định sẵn (chẳng hạn như DRIVE_PASS, PickUP hoặc nhớOUT) dựa trên loại địa điểm. Trường này bao gồm trường phụ là Ngày đặc biệt của tất cả các giờ, được đặt cho những ngày có giờ đặc biệt.
regularSecondaryOpeningHours[]

object (OpeningHours)

Chứa một loạt các mục nhập thông tin về giờ phụ thông thường của một doanh nghiệp. Giờ phụ khác với giờ chính của doanh nghiệp. Ví dụ: nhà hàng có thể chỉ định giờ mua hàng trên xe hoặc giờ giao hàng làm giờ phụ. Trường này điền sẵn trường con loại. Trường này lấy từ danh sách các loại giờ mở cửa định sẵn (chẳng hạn như DRIVE_PASS, PickUP hoặc nhớOUT) dựa trên loại địa điểm.
editorialSummary

object (LocalizedText)

Chứa thông tin tóm tắt về địa điểm. Bản tóm tắt bao gồm thông tin tổng quan dạng văn bản và cũng bao gồm mã ngôn ngữ cho những nội dung này (nếu có). Văn bản tóm tắt phải được trình bày nguyên trạng và không thể sửa đổi hoặc thay đổi.
paymentOptions

object (PaymentOptions)

Các lựa chọn thanh toán mà địa điểm chấp nhận. Nếu không có dữ liệu về lựa chọn thanh toán, trường tuỳ chọn thanh toán sẽ bị huỷ thiết lập.
parkingOptions

object (ParkingOptions)

Các lựa chọn về bãi đỗ xe do địa điểm cung cấp.
subDestinations[]

object (SubDestination)

Danh sách các điểm đến phụ liên quan đến địa điểm.
fuelOptions

object (FuelOptions)

Thông tin mới nhất về các lựa chọn nhiên liệu tại trạm xăng. Thông tin này được cập nhật thường xuyên.
evChargeOptions

object (EVChargeOptions)

Thông tin về các lựa chọn sạc xe.
utcOffsetMinutes

integer

Số phút múi giờ của địa điểm này hiện chênh lệch với giờ UTC. Giá trị này được biểu thị bằng phút để hỗ trợ các múi giờ được bù theo phân số của một giờ, ví dụ: X giờ và 15 phút.
userRatingCount

integer

Tổng số bài đánh giá (kèm theo hoặc không kèm theo nội dung) cho địa điểm này.
takeout

boolean

Chỉ định xem doanh nghiệp có hỗ trợ tính năng trích xuất hay không.
delivery

boolean

Chỉ rõ liệu doanh nghiệp có hỗ trợ giao hàng hay không.
dineIn

boolean

Chỉ định liệu doanh nghiệp có hỗ trợ các loại chỗ ngồi trong nhà hoặc ngoài trời hay không.
curbsidePickup

boolean

Chỉ định xem doanh nghiệp có hỗ trợ nhận hàng ở lề đường hay không.
reservable

boolean

Chỉ rõ địa điểm có hỗ trợ đặt chỗ hay không.
servesBreakfast

boolean

Chỉ định xem địa điểm có phục vụ bữa sáng hay không.
servesLunch

boolean

Chỉ định liệu địa điểm có phục vụ bữa ăn trưa hay không.
servesDinner

boolean

Chỉ định xem địa điểm đó có phục vụ bữa tối hay không.
servesBeer

boolean

Chỉ định xem địa điểm này có phục vụ bia hay không.
servesWine

boolean

Chỉ định xem địa điểm có phục vụ rượu vang hay không.
servesBrunch

boolean

Chỉ định xem địa điểm có phục vụ bữa sáng muộn hay không.
servesVegetarianFood

boolean

Chỉ định xem địa điểm đó có phục vụ đồ ăn chay hay không.
outdoorSeating

boolean

Địa điểm có chỗ ngồi ngoài trời.
liveMusic

boolean

Địa điểm có nhạc sống.
menuForChildren

boolean

Địa điểm có thực đơn dành cho trẻ em.
servesCocktails

boolean

Địa điểm phục vụ cocktail.
servesDessert

boolean

Địa điểm phục vụ món tráng miệng.
servesCoffee

boolean

Địa điểm phục vụ cà phê.
goodForChildren

boolean

Địa điểm phù hợp cho trẻ em.
allowsDogs

boolean

Địa điểm cho phép mang chó vào.
restroom

boolean

Địa điểm có nhà vệ sinh.
goodForGroups

boolean

Địa điểm phù hợp với khách theo nhóm.
goodForWatchingSports

boolean

Địa điểm này thích hợp để xem thể thao.
accessibilityOptions

object (AccessibilityOptions)

Thông tin về các phương án hỗ trợ người khuyết tật mà một địa điểm cung cấp.

LocalizedText

Biến thể đã bản địa hoá của văn bản bằng một ngôn ngữ cụ thể.

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "languageCode": string
}
Trường
text

string

Chuỗi đã bản địa hoá bằng ngôn ngữ tương ứng với languageCode bên dưới.
languageCode

string

Mã ngôn ngữ BCP-47 của văn bản, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

AddressComponent

Các thành phần có cấu trúc tạo thành địa chỉ đã định dạng, nếu có thông tin này.

Biểu diễn dưới dạng JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Trường
longText

string

Nội dung mô tả đầy đủ hoặc tên của thành phần địa chỉ. Ví dụ: thành phần địa chỉ cho quốc gia Úc có thể có tên long_name là "Úc".
shortText

string

Tên văn bản viết tắt cho thành phần địa chỉ, nếu có. Ví dụ: một thành phần địa chỉ cho quốc gia của Úc có thể có tên ngắn là "AU".
types[]

string

Một mảng cho biết(các) loại của thành phần địa chỉ.
languageCode

string

Ngôn ngữ dùng để định dạng các thành phần này, trong ký hiệu CLDR.

PlusCode

Mã cộng (http://plus.codes) là một mã tham chiếu vị trí có hai định dạng: mã chung xác định một hình chữ nhật có kích thước 14 m x 14 m (1/8000 độ) hoặc nhỏ hơn và mã phức hợp, thay thế tiền tố bằng một vị trí tham chiếu.

Biểu diễn dưới dạng JSON 
{
  "globalCode": string,
  "compoundCode": string
}
Trường
globalCode

string

Mã toàn cầu (đầy đủ) của địa điểm, chẳng hạn như "9FWM33GV+HQ", đại diện cho tỷ lệ 1/8000 x 1/8000 độ khu vực (~14 x 14 mét).
compoundCode

string

Mã phức hợp của địa điểm, chẳng hạn như "33GV+HQ, Ramberg, Na Uy", chứa hậu tố của mã chung và thay thế tiền tố bằng tên đã định dạng của một thực thể tham chiếu.

LatLng

Một đối tượng đại diện cho cặp vĩ độ/kinh độ. Thuộc tính này được biểu thị dưới dạng một cặp đôi đại diện cho độ vĩ độ và kinh độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi đã chuẩn hoá.

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính theo độ. Giá trị phải nằm trong phạm vi [-90.0, +90.0].
longitude

number

Kinh độ tính theo độ. Giá trị phải nằm trong phạm vi [-180.0, +180.0].

Khung nhìn

Một chế độ xem kinh độ – vĩ độ, được thể hiện dưới dạng hai điểm theo đường chéo đối diện low và high. Khung nhìn được xem là một khu vực khép kín, tức là nó bao gồm ranh giới của nó. Giới hạn vĩ độ phải nằm trong khoảng từ -90 đến 90 độ và giới hạn kinh độ phải nằm trong khoảng từ -180 đến 180 độ. Các trường hợp khác nhau bao gồm:

  • Nếu low = high, khung nhìn bao gồm một điểm duy nhất đó.

  • Nếu low.longitude > high.longitude, phạm vi kinh độ sẽ bị đảo ngược (khung nhìn vượt qua đường kinh độ 180 độ).

  • Nếu low.longitude = -180 độ và high.longitude = 180 độ, thì khung nhìn sẽ bao gồm tất cả các kinh độ.

  • Nếu low.longitude = 180 độ và high.longitude = -180 độ, thì phạm vi kinh độ sẽ trống.

  • Nếu low.latitude > high.latitude, thì phạm vi vĩ độ sẽ trống.

Cả low và high đều phải được điền và không được để trống hộp được đại diện (như được chỉ định trong các định nghĩa ở trên). Khung nhìn trống sẽ gây ra lỗi.

Ví dụ: khung nhìn này bao quanh đầy đủ Thành phố New York:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Biểu diễn dưới dạng JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Trường
low

object (LatLng)

Bắt buộc. Điểm thấp của khung nhìn.
high

object (LatLng)

Bắt buộc. Điểm cao của khung nhìn.

Bài đánh giá

Thông tin về bài đánh giá địa điểm.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
Trường
name

string

Tệp đối chiếu đại diện cho bài đánh giá về địa điểm này, có thể dùng để tra cứu lại bài đánh giá về địa điểm này (còn được gọi là tên "tài nguyên" API: places/{placeId}/reviews/{review}).
relativePublishTimeDescription

string

Một chuỗi thời gian gần đây được định dạng, thể hiện thời gian xem xét so với thời gian hiện tại theo một biểu mẫu phù hợp với ngôn ngữ và quốc gia.
text

object (LocalizedText)

Văn bản đã bản địa hoá của bài đánh giá.
originalText

object (LocalizedText)

Văn bản đánh giá bằng ngôn ngữ gốc.
rating

number

Một số từ 1,0 đến 5,0, còn được gọi là số sao.
authorAttribution

object (AuthorAttribution)

Tác giả của bài đánh giá này.
publishTime

string (Timestamp format)

Dấu thời gian cho bài đánh giá.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

AuthorAttribution

Thông tin về tác giả của dữ liệu nội dung do người dùng tạo. Dùng trong Photo và Review.

Biểu diễn dưới dạng JSON 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Trường
displayName

string

Tên tác giả của Photo hoặc Review.
uri

string

URI của tác giả của Photo hoặc Review.
photoUri

string

URI ảnh hồ sơ của tác giả của Photo hoặc Review.

OpeningHours

Thông tin về giờ làm việc của địa điểm.

Biểu diễn dưới dạng JSON 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
Trường
periods[]

object (Period)

Các khoảng thời gian mà địa điểm này mở cửa trong tuần. Các khoảng thời gian được sắp xếp theo trình tự thời gian, bắt đầu từ Chủ Nhật theo múi giờ địa phương – địa điểm. Giá trị trống (nhưng không vắng mặt) cho biết một địa điểm không bao giờ mở cửa, ví dụ: vì địa điểm đó tạm thời đóng cửa để nâng cấp.
weekdayDescriptions[]

string

Các chuỗi được bản địa hoá mô tả giờ mở cửa của địa điểm này, một chuỗi cho mỗi ngày trong tuần. Giá trị này sẽ trống nếu không xác định giờ được hoặc không thể chuyển đổi sang văn bản đã bản địa hoá. Ví dụ: "CN: 18:00–06:00"
secondaryHoursType

enum (SecondaryHoursType)

Một chuỗi loại dùng để xác định loại giờ phụ.
specialDays[]

object (SpecialDay)

Thông tin có cấu trúc cho những ngày đặc biệt nằm trong khoảng thời gian áp dụng cho giờ mở cửa đã trả lại. Ngày đặc biệt là những ngày có thể ảnh hưởng đến giờ làm việc của một địa điểm, ví dụ: ngày Giáng sinh. Đặt giá trị currentĐang mở cửa và Giờ mở cửa hiện tại nếu có giờ đặc biệt.
openNow

boolean

Địa điểm này có đang mở cửa không? Luôn hiển thị trừ phi chúng tôi thiếu dữ liệu thời gian trong ngày hoặc múi giờ cho những giờ mở cửa này.

Khoảng thời gian

Một khoảng thời gian mà địa điểm vẫn ở trạng thái openNow.

Biểu diễn dưới dạng JSON 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Trường
open

object (Point)

Thời gian mà địa điểm này bắt đầu mở cửa.
close

object (Point)

Thời gian mà địa điểm bắt đầu đóng cửa.

Điểm

Điểm thay đổi trạng thái.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Trường
date

object (Date)

Ngày theo múi giờ địa phương của địa điểm.
truncated

boolean

Liệu điểm cuối này có bị cắt bớt hay không. Rút ngắn xảy ra khi giờ thực tế nằm ngoài thời gian mà chúng ta sẵn sàng trả về các giờ, vì vậy chúng ta cắt ngắn giờ về các ranh giới này. Điều này đảm bảo rằng hệ thống sẽ trả về tối đa 24 * 7 giờ kể từ nửa đêm của ngày yêu cầu được trả về.
day

integer

Một ngày trong tuần, dưới dạng số nguyên trong phạm vi 0-6. 0 là Chủ Nhật, 1 là thứ Hai, v.v.
hour

integer

Giờ có 2 chữ số. Phạm vi từ 00 đến 23.
minute

integer

Phút có 2 chữ số. Phạm vi từ 00 đến 59.

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Dương lịch. Điều này có thể đại diện cho một trong những điều sau:

  • Một ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, có năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ có năm, có tháng 0 và ngày không.
  • Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày tháng. Giá trị phải từ 1 đến 9999 hoặc từ 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc từ 0 để chỉ định năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị cho năm và tháng, hoặc 0 để chỉ định riêng một năm hoặc một năm và tháng mà ngày đó không quan trọng.

SecondaryHoursType

Loại dùng để xác định loại giờ phụ.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Giá trị mặc định khi loại giờ phụ không được chỉ định.
DRIVE_THROUGH Giờ mua hàng trên xe đối với các ngân hàng, nhà hàng hoặc hiệu thuốc.
HAPPY_HOUR Giờ vàng.
DELIVERY Giờ giao hàng.
TAKEOUT Giờ bán đồ ăn mang đi.
KITCHEN Giờ làm bếp.
BREAKFAST Giờ ăn sáng.
LUNCH Giờ ăn trưa.
DINNER Giờ ăn tối.
BRUNCH Giờ ăn sáng muộn.
PICKUP Giờ đến lấy hàng.
ACCESS Giờ truy cập đối với các địa điểm lưu trữ.
SENIOR_HOURS Giờ đặc biệt dành cho người cao tuổi.
ONLINE_SERVICE_HOURS Giờ phục vụ trực tuyến.

SpecialDay

Thông tin có cấu trúc cho những ngày đặc biệt nằm trong khoảng thời gian áp dụng cho giờ mở cửa đã trả lại. Ngày đặc biệt là những ngày có thể ảnh hưởng đến giờ làm việc của một địa điểm, ví dụ: ngày Giáng sinh.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  }
}
Trường
date

object (Date)

Ngày của ngày đặc biệt này.

Ảnh

Thông tin về ảnh của một địa điểm.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
Trường
name

string

Giá trị nhận dạng. Tệp đối chiếu đại diện cho hình ảnh địa điểm này có thể dùng để tra cứu lại ảnh địa điểm này (còn được gọi là tên "tài nguyên" API: places/{placeId}/photos/{photo}).
widthPx

integer

Chiều rộng tối đa hiện có, tính bằng pixel.
heightPx

integer

Chiều cao tối đa hiện có, tính bằng pixel.
authorAttributions[]

object (AuthorAttribution)

Tác giả của ảnh này.

BusinessStatus

Trạng thái doanh nghiệp của địa điểm.

Enum
BUSINESS_STATUS_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
OPERATIONAL Cơ sở này đang hoạt động và chưa nhất thiết phải mở cửa.
CLOSED_TEMPORARILY Cơ sở này đang tạm thời đóng cửa.
CLOSED_PERMANENTLY Cơ sở này đã đóng cửa vĩnh viễn.

PriceLevel

Mức giá của địa điểm.

Enum
PRICE_LEVEL_UNSPECIFIED Mức giá của địa điểm chưa được xác định hoặc không xác định.
PRICE_LEVEL_FREE Địa điểm cung cấp các dịch vụ miễn phí.
PRICE_LEVEL_INEXPENSIVE Địa điểm cung cấp các dịch vụ rẻ.
PRICE_LEVEL_MODERATE Địa điểm cung cấp các dịch vụ có giá vừa phải.
PRICE_LEVEL_EXPENSIVE Địa điểm cung cấp các dịch vụ đắt tiền.
PRICE_LEVEL_VERY_EXPENSIVE Địa điểm cung cấp các dịch vụ rất đắt tiền.

Phân bổ

Thông tin về nhà cung cấp dữ liệu của địa điểm này.

Biểu diễn dưới dạng JSON 
{
  "provider": string,
  "providerUri": string
}
Trường
provider

string

Tên nhà cung cấp dữ liệu cho Địa điểm.
providerUri

string

URI tới nhà cung cấp dữ liệu của Địa điểm.

PaymentOptions

Các lựa chọn thanh toán mà địa điểm chấp nhận.

Biểu diễn dưới dạng JSON 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Trường
acceptsCreditCards

boolean

Địa điểm chấp nhận thanh toán bằng thẻ tín dụng.
acceptsDebitCards

boolean

Địa điểm chấp nhận thẻ ghi nợ làm thanh toán.
acceptsCashOnly

boolean

Địa điểm chỉ chấp nhận thanh toán bằng tiền mặt. Các địa điểm có thuộc tính này có thể vẫn chấp nhận các phương thức thanh toán khác.
acceptsNfc

boolean

Địa điểm chấp nhận thanh toán qua NFC.

ParkingOptions

Thông tin về các lựa chọn đỗ xe cho địa điểm. Một bãi đỗ xe có thể hỗ trợ nhiều lựa chọn cùng một lúc.

Biểu diễn dưới dạng JSON 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Trường
freeParkingLot

boolean

Địa điểm có bãi đỗ xe miễn phí.
paidParkingLot

boolean

Địa điểm có bãi đỗ xe có tính phí.
freeStreetParking

boolean

Địa điểm có chỗ đỗ xe miễn phí trên đường.
paidStreetParking

boolean

Địa điểm có bãi đỗ xe có tính phí trên đường.
valetParking

boolean

Địa điểm có dịch vụ đỗ xe.
freeGarageParking

boolean

Địa điểm có chỗ đỗ xe miễn phí.
paidGarageParking

boolean

Địa điểm có bãi đỗ xe có tính phí.

SubDestination

Đặt tên tài nguyên và mã nhận dạng của các điểm đến phụ liên quan đến địa điểm. Ví dụ: các nhà ga khác nhau là các điểm đến khác nhau của một sân bay.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "id": string
}
Trường
name

string

Tên tài nguyên của đích đến phụ.
id

string

Mã địa điểm của điểm đến phụ.

AccessibilityOptions

Thông tin về các phương án hỗ trợ người khuyết tật mà một địa điểm cung cấp.

Biểu diễn dưới dạng JSON 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Trường
wheelchairAccessibleParking

boolean

Địa điểm có chỗ đỗ xe cho xe lăn.
wheelchairAccessibleEntrance

boolean

Các địa điểm có lối vào cho xe lăn.
wheelchairAccessibleRestroom

boolean

Địa điểm có nhà vệ sinh cho xe lăn.
wheelchairAccessibleSeating

boolean

Địa điểm có chỗ ngồi cho xe lăn.

FuelOptions

Thông tin mới nhất về các lựa chọn nhiên liệu tại trạm xăng. Thông tin này được cập nhật thường xuyên.

Biểu diễn dưới dạng JSON 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Trường
fuelPrices[]

object (FuelPrice)

Giá nhiên liệu đã biết gần đây nhất cho mỗi loại nhiên liệu mà trạm này có. Có một mục nhập cho mỗi loại nhiên liệu mà trạm này có. Thứ tự không quan trọng.

FuelPrice

Thông tin về giá nhiên liệu cho một loại cụ thể.

Biểu diễn dưới dạng JSON 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Trường
type

enum (FuelType)

Loại nhiên liệu.
price

object (Money)

Giá nhiên liệu.
updateTime

string (Timestamp format)

Thời gian cập nhật giá nhiên liệu gần đây nhất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

FuelType

Loại nhiên liệu.

Enum
FUEL_TYPE_UNSPECIFIED Loại nhiên liệu chưa xác định.
DIESEL Nhiên liệu diesel.
REGULAR_UNLEADED Thông thường không dẫn.
MIDGRADE Loại trung.
PREMIUM Đặc biệt.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 Số SP 100.
LPG Khí dầu mỏ hoá lỏng (LPG).
E80 E 80.
E85 E 85.
METHANE Khí mêtan.
BIO_DIESEL Dầu diesel sinh học.
TRUCK_DIESEL Xe tải diesel.

Tiền

Thể hiện số tiền kèm theo loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Trường
currencyCode

string

Mã đơn vị tiền tệ gồm ba chữ cái được xác định trong ISO 4217.
units

string (int64 format)

Toàn bộ đơn vị của số tiền. Ví dụ: nếu currencyCode là "USD", thì 1 đơn vị là một đô la Mỹ.
nanos

integer

Số đơn vị nano (10^-9) của lượng. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999. Nếu units là số dương, thì nanos phải là số dương hoặc bằng 0. Nếu units bằng 0, nanos có thể là số dương, 0 hoặc âm. Nếu units là số âm, thì nanos phải là số âm hoặc 0. Ví dụ: $-1,75 được biểu diễn dưới dạng units=-1 và nanos=-750.000.000.

EVChargeOptions

Thông tin về Trạm sạc xe điện được lưu trữ tại Địa điểm. Thuật ngữ tuân theo https://afdc.energy.gov/fuels/electricity_infrastructure.html Một cổng có thể sạc một ô tô tại một thời điểm. Một cổng có một hoặc nhiều giắc cắm. Một trạm sạc có một hoặc nhiều cổng.

Biểu diễn dưới dạng JSON 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Trường
connectorCount

integer

Số lượng giắc cắm tại trạm này. Tuy nhiên, vì một số cổng có thể có nhiều giắc cắm nhưng chỉ có thể sạc mỗi lần một ô tô (ví dụ: số lượng giắc cắm có thể lớn hơn tổng số ô tô có thể sạc đồng thời).
connectorAggregation[]

object (ConnectorAggregation)

Danh sách các tổng hợp giắc cắm sạc xe điện có chứa các giắc cắm cùng loại và cùng tốc độ sạc.

ConnectorAggregation

Thông tin về chế độ sạc xe điện được nhóm theo [loại, maxChargeRateKw]. Cho thấy cách tổng hợp phí xe điện của các giắc cắm có cùng loại và tốc độ sạc tối đa (tính bằng kw).

Biểu diễn dưới dạng JSON 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Trường
type

enum (EVConnectorType)

Loại trình kết nối của phương thức tổng hợp này.
maxChargeRateKw

number

Tốc độ sạc tối đa tĩnh tính bằng kw của mỗi trình kết nối trong dữ liệu tổng hợp.
count

integer

Số trình kết nối trong dữ liệu tổng hợp này.
availabilityLastUpdateTime

string (Timestamp format)

Dấu thời gian khi thông tin về khả năng sử dụng trình kết nối trong bảng tổng hợp này được cập nhật lần gần đây nhất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
availableCount

integer

Số lượng trình kết nối hiện có trong dữ liệu tổng hợp này.
outOfServiceCount

integer

Số lượng trình kết nối trong dữ liệu tổng hợp này hiện không hoạt động.

EVConnectorType

Hãy truy cập vào http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 để biết thêm thông tin/ngữ cảnh về các loại giắc cắm sạc xe điện.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Trình kết nối chưa được chỉ định.
EV_CONNECTOR_TYPE_OTHER Các loại trình kết nối khác.
EV_CONNECTOR_TYPE_J1772 J1772 đầu nối loại 1.
EV_CONNECTOR_TYPE_TYPE_2 Đầu nối IEC 62196 loại 2. Thường được gọi là MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Trình kết nối loại CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Hệ thống sạc kết hợp (AC và DC). Dựa trên SAE. Đầu nối Loại 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Hệ thống sạc kết hợp (AC và DC). Dựa trên giắc cắm Mennekes Type-2
EV_CONNECTOR_TYPE_TESLA Trình kết nối TESLA chung. Đây là NACS ở Bắc Mỹ nhưng có thể không phải là NACS ở các nơi khác trên thế giới (ví dụ: CCS Kết hợp 2 (CCS2) hoặc GB/T). Giá trị này ít đại diện cho loại giắc cắm thực tế hơn và thể hiện khả năng sạc xe ô tô thương hiệu Tesla tại trạm sạc thuộc sở hữu của Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Loại GB/T tương ứng với tiêu chuẩn GB/T ở Trung Quốc. Loại này bao gồm tất cả các loại GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Ổ cắm trên tường không xác định.

Phương thức

autocomplete

 Trả về kết quả dự đoán cho dữ liệu đầu vào đã cho.

get

 Lấy thông tin chi tiết về một địa điểm dựa trên tên tài nguyên của địa điểm đó, là một chuỗi ở định dạng places/{place_id}.

searchNearby

 Tìm địa điểm gần các địa điểm.

searchText

 Tìm kiếm địa điểm dựa trên truy vấn văn bản.