REST Resource: places

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

Tất cả thông tin về 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)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "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 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 đã bản địa hoá của địa điểm, phù hợp làm một đoạn mô tả ngắn gọn mà con người có thể đọc được. Ví dụ: "Google Sydney", " gần", "Pyrmont", v.v.

types[]

string

Một bộ thẻ loại cho kết quả này. Ví dụ: "chính trị" và "địa phương". Để biết 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 những loại được hỗ trợ API Địa điểm. 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. Để biết 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ó). Để biết 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 cho địa điểm, ở định dạng quốc gia.

internationalPhoneNumber

string

Số điện thoại mà con người có thể đọc được cho đị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 gọn mà con người có thể đọc được cho địa điểm này.

addressComponents[]

object (AddressComponent)

Các thành phần lặp lại cho mỗi cấp địa phương. Vui lòng lưu ý các thông tin sau về mảng addressComponents[]: – Mảng địa chỉ có thể chứa nhiều thành phần hơn so với định dạngAddress. - Mảng đó không nhất thiết phải bao gồm tất cả các pháp nhân chính trị có chứa một địa chỉ, ngoại trừ những pháp nhân có trong định dạngAddress. Để truy xuất tất cả các thực thể chính trị chứa một địa chỉ cụ thể, bạn nên sử dụng mã hoá địa lý ngược, truyền vĩ độ/kinh độ của địa chỉ dưới dạng tham số đến yêu cầu. – Chúng tôi không đảm bảo rằng định dạng của phản hồi sẽ 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 câu trả lời sau.

plusCode

object (PlusCode)

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

location

object (LatLng)

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

viewport

object (Viewport)

Chế độ xem phù 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 đáng tin cậy cho địa điểm này, ví dụ: doanh nghiệp trang chủ. Xin lưu ý rằng đối với những địa điểm thuộc một chuỗi (ví dụ: một cửa hàng IKEA), đây thường sẽ là trang web của từng cửa hàng, chứ không phải của toàn bộ chuỗi.

reviews[]

object (Review)

Danh sách 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ả lại 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 ở định dạng siêu nhỏ adr: 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 nhóm 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 thành 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ố của loại biểu tượng 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ờ hoạt động trong 7 ngày tới (kể cả hôm nay). Khoảng thời gian này bắt đầu từ nửa đêm của ngày gửi yêu cầu và kết thúc lúc 23:59 đêm sáu ngày sau đó. Trường này bao gồm trường phụ Special ngày 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ờ làm việc phụ của doanh nghiệp. Giờ làm việc phụ khác với giờ chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ mua hàng tận nơi hoặc giờ giao hàng làm giờ phụ. Trường này điền sẵn trường phụ loại mà lấy từ danh sách các loại giờ mở cửa được xác định sẵn (chẳng hạn như DRIVE_Through, PICKUP hoặc chiếm) dựa trên loại địa điểm. Trường này bao gồm trường phụ Special ngày 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ờ làm việc thứ cấp thông thường của một doanh nghiệp. Giờ làm việc phụ khác với giờ chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ mua hàng tận nơi hoặc giờ giao hàng làm giờ phụ. Trường này điền sẵn trường phụ loại mà lấy từ danh sách các loại giờ mở cửa được xác định sẵn (chẳng hạn như DRIVE_Through, PICKUP hoặc chiếm) 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 nội dung tổng quan dạng văn bản và bao gồm cả mã ngôn ngữ (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 được sửa đổi hoặc thay đổi.

paymentOptions

object (PaymentOptions)

Các hình thức thanh toán mà địa điểm đó chấp nhận. Nếu không có dữ liệu về phương thức thanh toán, trường phương thức thanh toán này sẽ bị huỷ thiết lập.

parkingOptions

object (ParkingOptions)

Các lựa chọn về chỗ đỗ 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 ở một 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 ev.

generativeSummary

object (GenerativeSummary)

Thử nghiệm: Xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Bản tóm tắt do AI tạo về địa điểm.

areaSummary

object (AreaSummary)

Thử nghiệm: Xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Bản tóm tắt do AI tạo về khu vực có địa điểm đó.

utcOffsetMinutes

integer

Số phút múi giờ của địa điểm này hiện được bù trừ so 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ù trừ bằng 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á (có hoặc không có văn bản) cho địa điểm này.

takeout

boolean

Cho biết doanh nghiệp có hỗ trợ mua mang đi hay không.

delivery

boolean

Cho biết doanh nghiệp có hỗ trợ phân phối hay không.

dineIn

boolean

Cho biết doanh nghiệp có hỗ trợ lựa chọn chỗ ngồi trong nhà hoặc ngoài trời hay không.

curbsidePickup

boolean

Cho biết doanh nghiệp có hỗ trợ nhận hàng ở lề đường hay không.

reservable

boolean

Chỉ định liệu địa điểm có hỗ trợ đặt chỗ hay không.

servesBreakfast

boolean

Cho biết địa điểm có phục vụ bữa sáng hay không.

servesLunch

boolean

Chỉ định xem địa điểm có phục vụ bữa 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 việc địa điểm có phục vụ bia hay không.

servesWine

boolean

Cho biết địa điểm có phục vụ rượu vang hay không.

servesBrunch

boolean

Cho biết địa điểm có phục vụ bữa nửa buổi hay không.

servesVegetarianFood

boolean

Cho biết đị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 chó.

restroom

boolean

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

goodForGroups

boolean

Địa điểm dành cho nhóm.

goodForWatchingSports

boolean

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

accessibilityOptions

object (AccessibilityOptions)

Thông tin về các lựa chọ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 một văn bản trong 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 dưới đây.

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 truy cập vào 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ỉ được đị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 đủ bằng văn bản 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ó long_name là "Úc".

shortText

string

Tên viết tắt bằng văn bản cho thành phần địa chỉ, nếu có. Ví dụ: thành phần địa chỉ cho quốc gia Úc có thể có short_name 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, theo ký hiệu CLDR.

PlusCode

Mã cộng (http://plus.codes) là tham chiếu vị trí với hai định dạng: mã toàn cục xác định hình chữ nhật nhỏ hơn hoặc 14mx14m (1/8000 độ) và mã phức hợp, thay thế tiền tố bằng 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 khu vực 1/8000 x 1/8000 độ (~ 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ã toàn cục và thay thế tiền tố bằng tên đã được định dạng của thực thể tham chiếu.

LatLng

Đối tượng đại diện cho cặp vĩ độ/kinh độ. Giá trị này được biểu thị bằng cặp số đạ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 bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].

longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

Khung nhìn

Khung nhìn vĩ độ – kinh độ, được biểu thị bằng hai đường chéo đối diện điểm lowhigh. Một khung nhìn được xem là một khu vực đóng, tức là khu vực đó bao gồm cả 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ó nhiều trường hợp như sau:

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

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

  • Nếu low.longitude = -180 độ và high.longitude = 180 độ, 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 độ trống.

  • Nếu low.latitude > high.latitude, phạm vi vĩ độ bị trống.

Cả lowhigh đều phải được điền và không được để trống ô được thể hiện (như được chỉ định trong các định nghĩa ở trên). Chế độ xem trống sẽ dẫn đến lỗi.

Ví dụ: khung nhìn này bao quanh hoàn toàn 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á về một đị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

Một tệp tham chiếu đại diện cho bài đánh giá về địa điểm này có thể được 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

Chuỗi thời gian gần đây được định dạng, thể hiện thời gian xem xét tương ứng với thời gian hiện tại ở dạng 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)

Nội dung bài đánh giá bằng ngôn ngữ gốc.

rating

number

Số từ 1.0 đến 5.0, còn 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 của bài đánh giá.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

AuthorAttribution

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

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)

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

weekdayDescriptions[]

string

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. Sẽ trống nếu giờ không xác định 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 ký tự 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 chứa giờ mở cửa được trả về. 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ờ hiện tại Giờ mở 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 về 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

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 địa điểm bắt đầu mở cửa.

close

object (Point)

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

Điểm

Điểm đang 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. Việc cắt bớt xảy ra khi giờ thực nằm ngoài thời gian mà chúng tôi sẵn sàng trả lại giờ, vì vậy chúng tôi cắt bớt giờ trở lại các giới hạn này. Điều này đảm bảo rằng 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ờ bằng 2 chữ số. Phạm vi từ 00 đến 23.

minute

integer

Phút bằng 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ư ngày 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 Lịch Gregory. Thông tin này có thể là một trong những trường hợp sau:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, thể hiện giá trị năm 0 (ví dụ: ngày kỷ niệm).
  • Một năm riêng biệt, tháng không tháng và ngày không thá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 có 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. Giá trị phải từ 1 đến 9999 hoặc bằng 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 bằng 0 để chỉ định một năm không có tháng và ngày.

day

integer

Ngày trong tháng. Phải có giá trị từ 1 đến 31 và có giá trị hợp lệ trong năm và tháng, hoặc bằng 0 để chỉ định một năm độc lập hoặc là một năm và tháng mà ngày không quan trọng.

SecondaryHoursType

Một 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ờ giao hàng ngay 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 nửa buổi.
PICKUP Giờ đến lấy hàng.
ACCESS Giờ truy cập cho 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ờ cung cấp dịch 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 chứa giờ mở cửa được trả về. 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ề hình ảnh về 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. Một tệp đối chiếu đại diện cho hình ảnh về địa điểm này có thể được dùng để tra cứu lại ảnh về đị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 cho địa điểm.

Enum
BUSINESS_STATUS_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
OPERATIONAL Cơ sở đang hoạt động, không nhất thiết đang mở cửa ngay bây giờ.
CLOSED_TEMPORARILY Cơ sở này tạm thời đóng cửa.
CLOSED_PERMANENTLY Cơ sở đã bị đó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 này cung cấp các dịch vụ miễn phí.
PRICE_LEVEL_INEXPENSIVE Nơi này cung cấp các dịch vụ giá rẻ.
PRICE_LEVEL_MODERATE Địa điểm này cung cấp các dịch vụ với giá phải chăng.
PRICE_LEVEL_EXPENSIVE Địa điểm này cung cấp các dịch vụ đắt tiền.
PRICE_LEVEL_VERY_EXPENSIVE Địa điểm này 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 cho địa điểm này.

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

string

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

providerUri

string

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

PaymentOptions

Các hình thức 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 thanh toán bằng thẻ ghi nợ.

acceptsCashOnly

boolean

Địa điểm chỉ chấp nhận thanh toán bằng tiền mặt. Những địa điểm có thuộc tính này vẫn có thể 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 NFC.

ParkingOptions

Thông tin về các lựa chọn đỗ xe cho địa điểm. 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 này có bãi đỗ xe miễn phí.

paidParkingLot

boolean

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

freeStreetParking

boolean

Khách sạn có chỗ đỗ xe miễn phí trên đường.

paidStreetParking

boolean

Khách sạn có chỗ đỗ xe có tính phí trên đường.

valetParking

boolean

Khách sạn có dịch vụ đỗ xe.

freeGarageParking

boolean

Khách sạn có gara đỗ xe miễn phí.

paidGarageParking

boolean

Khách sạn có gara đỗ xe có tính phí.

SubDestination

Đặt tên tài nguyên và mã nhận dạng của các đích đế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 đích đến phụ.

AccessibilityOptions

Thông tin về các lựa chọ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

Khách sạn 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 ở một 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 gần đây nhất được biết của mỗi loại nhiên liệu mà trạm này có. Mỗi loại nhiên liệu có một vé vào trạm này. 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á của nhiên liệu.

updateTime

string (Timestamp format)

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

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""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 Không có chì thông thường.
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 100 SP.
LPG khí dầu mỏ hoá lỏng (LPG).
E80 E 80.
E85 E 85.
METHANE Khí mêtan.
BIO_DIESEL Dầu sinh học.
TRUCK_DIESEL Xe tải chạy dầu.

Tiền

Đại diện cho 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"USD", thì 1 đơn vị sẽ là 1 đô la Mỹ.

nanos

integer

Số lượng nano (10^-9) đơn vị 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 có giá trị dương hoặc 0. Nếu units bằng 0, nanos có thể là số dương, 0 hoặc số âm. Nếu units là số âm thì nanos phải có giá trị âm hoặc 0. Ví dụ: $-1,75 được biểu thị 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 chỗ. Thuật ngữ tuân theo https://afdc.energy.gov/fuels/electricity_infrastructure.html Một cổng có thể sạc mỗi lần một ô tô. Một cổng có một hoặc nhiều giắc cắm. Một trạm 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ụ:) nên số lượng giắc cắm có thể lớn hơn tổng số ô tô có thể sạc cùng lúc.

connectorAggregation[]

object (ConnectorAggregation)

Danh sách tổng hợp các 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ề quá trình sạc xe điện được nhóm theo [loại, maxChargeRateKw]. Hiển thị bảng tổng hợp phí xe điện của các giắc cắm có cùng loại và mứ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 dữ liệu 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 đầu nối trong dữ liệu tổng hợp.

count

integer

Số lượng 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 được cập nhật lần gần đây nhất khi thông tin về khả năng sử dụng của trình kết nối trong dữ liệu tổng hợp này.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

availableCount

integer

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

outOfServiceCount

integer

Số trình kết nối trong tập 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/bối 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 không xác định.
EV_CONNECTOR_TYPE_OTHER Các loại trình kết nối khác.
EV_CONNECTOR_TYPE_J1772 Đầu nối loại 1 J1772.
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 Type-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 trình kết nối Mennekes Loại 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 Gói 2 (CCS2) hoặc GB/T). Giá trị này ít đại diện hơn cho loại giắc cắm thực tế và thể hiện khả năng sạc xe thương hiệu Tesla tại trạm sạc do Tesla sở hữu.
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 áp dụng cho tất cả các loại GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Ổ cắm trên tường chưa xác định.

GenerativeSummary

Thử nghiệm: Xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Bản tóm tắt do AI tạo về địa điểm.

Biểu diễn dưới dạng JSON
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Trường
overview

object (LocalizedText)

Tổng quan về địa điểm.

description

object (LocalizedText)

Mô tả chi tiết về địa điểm.

references

object (References)

Tài liệu tham khảo dùng để tạo nội dung mô tả tóm tắt.

Tài liệu tham khảo

Thử nghiệm: Xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Thông tin tham chiếu có liên quan đến nội dung tạo sinh.

Biểu diễn dưới dạng JSON
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Trường
reviews[]

object (Review)

Các bài đánh giá đóng vai trò là tệp đối chiếu.

places[]

string

Danh sách tên tài nguyên của các địa điểm được tham chiếu. Bạn có thể dùng tên này trong các API khác chấp nhận tên tài nguyên địa điểm.

AreaSummary

Thử nghiệm: Xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Bản tóm tắt do AI tạo về khu vực có địa điểm đó.

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

object (ContentBlock)

Các khối nội dung tạo nên bản tóm tắt khu vực. Mỗi khối có một chủ đề riêng về khu vực đó.

ContentBlock

Một khối nội dung có thể được phân phát riêng lẻ.

Biểu diễn dưới dạng JSON
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Trường
topic

string

Chủ đề của nội dung, ví dụ: "tổng quan" hoặc "nhà hàng".

content

object (LocalizedText)

Nội dung liên quan đến chủ đề.

references

object (References)

Thử nghiệm: Xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Tệp tham chiếu có liên quan đến khối nội dung này.

Phương thức

autocomplete

Trả về thông tin dự đoán cho đầ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 vị trí.

searchText

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