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,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "consumerAlert": {
    object (ConsumerAlert)
  },
  "movedPlace": string,
  "movedPlaceId": string,
  "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)
  },
  "pureServiceAreaBusiness": boolean
}
Trường
name

string

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

string

Giá trị nhận dạng riêng biệ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 làm nội dung mô tả ngắn mà con người có thể đọc được. Ví dụ: "Google Sydney", "Starbucks", "Pyrmont", v.v.
types[]

string

Một nhóm thẻ loại cho kết quả này. Ví dụ: "political" và "locality". Để 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 những loại được Places API hỗ trợ. 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. Loại chính có thể bị thiếu nếu loại chính của địa điểm không phải là loại được hỗ trợ. Khi có loại chính, loại đó luôn là một trong các loại trong trường types.
primaryTypeDisplayName

object (LocalizedText)

Tên hiển thị của loại chính, được bản địa hoá theo 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. Loại chính có thể bị thiếu nếu loại chính của địa điểm không phải là loại được hỗ trợ.
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 dễ đọc của địa điểm, ở định dạng quốc tế.
formattedAddress

string

Địa chỉ đầy đủ, dễ đọc của địa điểm này.
shortFormattedAddress

string

Địa chỉ ngắn, dễ đọc cho địa điểm này.
postalAddress

object (PostalAddress)

Địa chỉ ở định dạng địa chỉ bưu chính.
addressComponents[]

object (AddressComponent)

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

Plus Code của vĩ độ/kinh độ vị trí của địa điểm.
location

object (LatLng)

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

object (Viewport)

Một khung hiển thị phù hợp để hiển thị địa điểm trên bản đồ có kích thước trung bình. Bạn không nên sử dụng khung hiển thị này làm ranh giới thực tế hoặc khu vực kinh doanh của doanh nghiệp.
rating

number

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

string

Một 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 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. Hệ thống có thể trả về tối đa 5 bài đánh giá.
regularOpeningHours

object (OpeningHours)

Giờ hoạt động thông thường. Xin lưu ý rằng nếu một địa điểm luôn mở cửa (24 giờ), thì trường close sẽ không được đặt. Các ứng dụng có thể dựa vào trạng thái luôn mở cửa (24 giờ) được biểu thị dưới dạng khoảng thời gian open chứa day có giá trị 0, hour có giá trị 0 và minute có giá trị 0.
timeZone

object (TimeZone)

Múi giờ trong Cơ sở dữ liệu múi giờ của IANA. Ví dụ: "America/New_York".
photos[]

object (Photo)

Thông tin (bao gồm cả thông tin tham khảo) về ảnh của địa điểm này. Hệ thống có thể trả về tối đa 10 bức ảnh.
adrFormatAddress

string

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

enum (BusinessStatus)

Trạng thái kinh doanh 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 xuất hiện cùng với kết quả này.
iconMaskBaseUri

string

URL bị cắt ngắn đến một mặt nạ biểu tượng. Người dùng có thể truy cập vào các loại biểu tượng khác nhau 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ờ 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 vào ngày yêu cầu và kết thúc lúc 23:59 sáu ngày sau đó. Trường này bao gồm trường con specialDays của tất cả các giờ, được đặt cho những ngày có giờ hoạt động đặc biệt.
currentSecondaryOpeningHours[]

object (OpeningHours)

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

object (OpeningHours)

Chứa một mảng các mục nhập thông tin về giờ hoạt động phụ thường xuyên của một doanh nghiệp. Giờ hoạt động phụ khác với giờ hoạt động chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ mua hàng ngay trên xe hoặc giờ giao hàng là giờ hoạt động phụ. Trường này sẽ điền sẵn vào trường phụ loại, lấy dữ liệu từ danh sách được xác định trước về các loại giờ hoạt động (chẳng hạn như DRIVE_THROUGH, PICKUP hoặc TAKEOUT) dựa trên các 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 bằng văn bản và mã ngôn ngữ (nếu có). Bạn phải trình bày văn bản tóm tắt nguyên trạng và không được sửa đổi hoặc thay đổi.
paymentOptions

object (PaymentOptions)

Các phương thức 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 lựa chọn thanh toán sẽ không được đặt.
parkingOptions

object (ParkingOptions)

Các lựa chọn đỗ 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 loại nhiên liệu tại 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 điện.
generativeSummary

object (GenerativeSummary)

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

object (ContainingPlace)

Danh sách các địa điểm mà địa điểm hiện tại nằm trong đó.
addressDescriptor

object (AddressDescriptor)

Thông tin mô tả địa chỉ của địa điểm. Nội dung mô tả địa chỉ bao gồm thông tin bổ sung giúp mô tả một vị trí bằng cách sử dụng địa danh và khu vực. Xem phạm vi theo khu vực của bộ mô tả địa chỉ tại https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
priceRange

object (PriceRange)

Phạm vi giá liên kết với một Địa điểm.
reviewSummary

object (ReviewSummary)

Bản tóm tắt do AI tạo về địa điểm dựa trên bài đánh giá của người dùng.
evChargeAmenitySummary

object (EvChargeAmenitySummary)

Thông tin tóm tắt về các tiện nghi gần trạm sạc xe điện.
neighborhoodSummary

object (NeighborhoodSummary)

Tóm tắt các địa điểm yêu thích ở gần nơi đó.
consumerAlert

object (ConsumerAlert)

Thông báo cảnh báo người tiêu dùng cho địa điểm khi chúng tôi phát hiện thấy hoạt động đánh giá đáng ngờ về một doanh nghiệp hoặc khi một doanh nghiệp vi phạm chính sách của chúng tôi.
movedPlace

string

Nếu Địa điểm này đã đóng cửa vĩnh viễn và chuyển đến một Địa điểm mới, thì trường này sẽ chứa tên tài nguyên của Địa điểm mới, ở định dạng places/{placeId}. Nếu Địa điểm này di chuyển nhiều lần, trường này sẽ đại diện cho địa điểm di chuyển lần đầu tiên. Trường này sẽ không được điền sẵn nếu Địa điểm này chưa di chuyển.
movedPlaceId

string

Nếu Địa điểm này đã đóng cửa vĩnh viễn và chuyển đến một Địa điểm mới, thì trường này sẽ chứa mã địa điểm của Địa điểm mới. Nếu Địa điểm này đã di chuyển nhiều lần, thì trường này sẽ đại diện cho Địa điểm di chuyển lần đầu tiên. Trường này sẽ không được điền sẵn nếu Địa điểm này chưa di chuyển.
utcOffsetMinutes

integer

Số phút mà múi giờ của địa điểm này hiện đang lệch 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ó độ lệch bằng một phần 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

Cho biết liệu doanh nghiệp có hỗ trợ dịch vụ mang đi hay không.
delivery

boolean

Cho biết liệu doanh nghiệp có hỗ trợ dịch vụ giao hàng hay không.
dineIn

boolean

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

boolean

Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ lấy hàng tại lề đường hay không.
reservable

boolean

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

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

boolean

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

boolean

Cho biết địa điểm 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

Cho biết địa điểm có phục vụ bữa sáng muộn 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 này có chỗ ngồi ngoài trời.
liveMusic

boolean

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

boolean

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

boolean

Địa điểm này có phục vụ cocktail.
servesDessert

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Địa điểm có thể tiếp đón các nhóm.
goodForWatchingSports

boolean

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

object (AccessibilityOptions)

Thông tin về các lựa chọn hỗ trợ tiếp cận mà một địa điểm cung cấp.
pureServiceAreaBusiness

boolean

Cho biết liệu địa điểm đó có phải là doanh nghiệp chỉ cung cấp dịch vụ tại khu vực kinh doanh hay không. Doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng là doanh nghiệp trực tiếp cung cấp dịch vụ tận nơi hoặc giao hàng cho khách hàng, nhưng không phục vụ khách hàng tại địa chỉ doanh nghiệp. Ví dụ: Những doanh nghiệp cung cấp dịch vụ vệ sinh hoặc sửa ống nước. Những doanh nghiệp đó có thể không có địa chỉ thực tế hoặc vị trí trên Google Maps.

LocalizedText

Biến thể được bản địa hoá của một 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 được 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.

PostalAddress (Địa chỉ bưu điện)

Biểu thị địa chỉ bưu chính, chẳng hạn như địa chỉ giao hàng hoặc địa chỉ thanh toán qua đường bưu điện. Với địa chỉ bưu chính, dịch vụ bưu chính có thể giao các mặt hàng đến một cơ sở, hộp thư bưu điện hoặc địa chỉ tương tự. Địa chỉ bưu chính không dùng để mô hình hoá các vị trí địa lý như đường, thị trấn hoặc núi.

Trong cách sử dụng thông thường, địa chỉ sẽ được tạo bằng thông tin đầu vào của người dùng hoặc từ việc nhập dữ liệu hiện có, tuỳ thuộc vào loại quy trình.

Lời khuyên về cách nhập hoặc chỉnh sửa địa chỉ:

  • Sử dụng một tiện ích địa chỉ sẵn sàng cho việc quốc tế hoá, chẳng hạn như https://github.com/google/libaddressinput.
  • Người dùng không được nhìn thấy các phần tử trên giao diện người dùng để nhập hoặc chỉnh sửa các trường bên ngoài những quốc gia nơi trường đó được sử dụng.

Để biết thêm hướng dẫn về cách sử dụng giản đồ này, hãy xem: https://support.google.com/business/answer/6397478.

Biểu diễn dưới dạng JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Trường
revision

integer

Bản sửa đổi giản đồ của PostalAddress. Bạn phải đặt giá trị này thành 0, tức là phiên bản sửa đổi mới nhất.

Tất cả các bản sửa đổi mới phải tương thích ngược với các bản sửa đổi cũ.
regionCode

string

Bắt buộc. Mã vùng CLDR của quốc gia/khu vực có địa chỉ. Giá trị này không bao giờ được suy luận và người dùng phải đảm bảo giá trị này là chính xác. Hãy xem https://cldr.unicode.org/ và https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết thông tin chi tiết. Ví dụ: "CH" cho Thuỵ Sĩ.
languageCode

string

Không bắt buộc. Mã ngôn ngữ BCP-47 của nội dung tại địa chỉ này (nếu có). Đây thường là ngôn ngữ giao diện người dùng của biểu mẫu nhập hoặc dự kiến sẽ khớp với một trong các ngôn ngữ được dùng ở quốc gia/khu vực của địa chỉ hoặc các ngôn ngữ tương đương được chuyển tự. Điều này có thể ảnh hưởng đến định dạng ở một số quốc gia, nhưng không ảnh hưởng đến tính chính xác của dữ liệu và sẽ không bao giờ ảnh hưởng đến bất kỳ hoạt động xác thực hoặc hoạt động không liên quan đến định dạng nào khác.

Nếu bạn không biết giá trị này, bạn nên bỏ qua (thay vì chỉ định một giá trị mặc định có thể không chính xác).

Ví dụ: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Không bắt buộc. Mã bưu chính của địa chỉ. Không phải quốc gia nào cũng sử dụng hoặc yêu cầu phải có mã bưu chính, nhưng ở những nơi sử dụng mã bưu chính, mã này có thể kích hoạt quy trình xác thực bổ sung với các phần khác của địa chỉ (ví dụ: xác thực tiểu bang hoặc mã zip ở Hoa Kỳ).
sortingCode

string

Không bắt buộc. Mã chi nhánh bổ sung theo từng quốc gia. Thuộc tính này không được dùng ở hầu hết các khu vực. Khi được sử dụng, giá trị này có thể là một chuỗi như "CEDEX", có thể theo sau là một số (ví dụ: "CEDEX 7"), hoặc chỉ là một số, biểu thị "mã khu vực" (Jamaica), "chỉ báo khu vực giao hàng" (Malawi) hoặc "chỉ báo bưu điện" (Côte d'Ivoire).
administrativeArea

string

Không bắt buộc. Phân khu hành chính cao nhất được dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: đây có thể là một tiểu bang, tỉnh, vùng hoặc tỉnh. Đối với Tây Ban Nha, đây là tỉnh chứ không phải cộng đồng tự trị (ví dụ: "Barcelona" chứ không phải "Catalonia"). Nhiều quốc gia không sử dụng khu vực hành chính trong địa chỉ bưu chính. Ví dụ: Ở Thuỵ Sĩ, bạn không nên điền thông tin này.
locality

string

Không bắt buộc. Thường đề cập đến phần thành phố hoặc thị trấn của địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, comune ở Ý, thị trấn bưu điện ở Vương quốc Anh. Ở những khu vực trên thế giới mà địa phương không được xác định rõ hoặc không phù hợp với cấu trúc này, hãy để trống locality và sử dụng addressLines.
sublocality

string

Không bắt buộc. Tiểu khu của địa chỉ. Ví dụ: đây có thể là một khu dân cư, thị xã hoặc quận.
addressLines[]

string

Dòng địa chỉ không có cấu trúc mô tả các cấp thấp hơn của một địa chỉ.

Vì các giá trị trong addressLines không có thông tin về loại và đôi khi có thể chứa nhiều giá trị trong một trường (ví dụ: "Austin, TX"), nên bạn cần phải sắp xếp các dòng một cách rõ ràng. Thứ tự của các dòng địa chỉ phải là "thứ tự trên phong bì" đối với quốc gia hoặc khu vực của địa chỉ. Ở những nơi có thể có sự khác biệt (ví dụ: Nhật Bản), address_language được dùng để nêu rõ (ví dụ: "ja" cho thứ tự từ lớn đến nhỏ và "ja-Latn" hoặc "en" cho thứ tự từ nhỏ đến lớn). Bằng cách này, bạn có thể chọn dòng địa chỉ cụ thể nhất dựa trên ngôn ngữ.

Mức biểu thị cấu trúc tối thiểu được phép của một địa chỉ bao gồm một regionCode với tất cả thông tin còn lại được đặt trong addressLines. Bạn có thể định dạng một địa chỉ như vậy một cách rất gần đúng mà không cần mã hoá địa lý, nhưng không thể đưa ra lý luận ngữ nghĩa về bất kỳ thành phần nào của địa chỉ cho đến khi địa chỉ đó được phân giải ít nhất một phần.

Tạo một địa chỉ chỉ chứa regionCode và addressLines rồi mã hoá địa lý là cách nên dùng để xử lý các địa chỉ hoàn toàn không có cấu trúc (thay vì đoán xem phần nào của địa chỉ nên là địa phương hoặc khu vực hành chính).
recipients[]

string

Không bắt buộc. Người nhận tại địa chỉ. Trong một số trường hợp, trường này có thể chứa thông tin trên nhiều dòng. Ví dụ: địa chỉ này có thể chứa thông tin "nhờ chuyển đến".
organization

string

Không bắt buộc. Tên của tổ chức tại địa chỉ.

AddressComponent

Các thành phần có cấu trúc tạo nên đị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ả hoặc tên đầy đủ của thành phần địa chỉ. Ví dụ: một thành phần địa chỉ cho quốc gia Úc có thể có long_name là "Úc".
shortText

string

Tên văn bản viết tắt của 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 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

Plus code (http://plus.codes) là thông tin tham chiếu về vị trí có 2 định dạng: mã toàn cầu 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ã kết 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", biểu thị một khu vực có kích thước 1/8000 x 1/8000 độ (~14 x 14 mét).
compoundCode

string

Mã kết hợp của địa điểm, chẳng hạn như "33GV+HQ, Ramberg, Na Uy", có chứa hậu tố của mã toàn cầu và thay thế tiền tố bằng tên được đị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 độ. Thông tin này được biểu thị dưới dạng một cặp số thực có độ chính xác gấp đôi để biểu thị vĩ độ và kinh độ theo độ. 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 được 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

Một khung hiển thị theo vĩ độ và kinh độ, được biểu thị dưới dạng 2 điểm low và high đối diện theo đường chéo. Khung nhìn được coi là một vùng khép kín, tức là bao gồm cả ranh giới của vùng đó. Phạm vi vĩ độ phải nằm trong khoảng từ -90 đến 90 độ (bao gồm cả hai giá trị này), còn phạm vi kinh độ phải nằm trong khoảng từ -180 đến 180 độ (bao gồm cả hai giá trị này). Một số trường hợp như:

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

  • Nếu low.longitude > high.longitude, thì 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ả 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.

Bạn phải điền cả low và high, đồng thời không được để trống hộp được biểu thị (như được chỉ định theo các định nghĩa ở trên). Một khung hiển thị trống sẽ dẫn đến lỗi.

Ví dụ: khung hiển thị này bao trọ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 nhất của khung nhìn.
high

object (LatLng)

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

Xem xét

Thông tin về bài đánh giá 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,
  "flagContentUri": string,
  "googleMapsUri": string,
  "visitDate": {
    object (Date)
  }
}
Trường
name

string

Một thông tin tham chiếu đại diện cho bài đánh giá này về địa điểm. Bạn có thể dùng thông tin này để tra cứu lại bài đánh giá này về địa điểm (còn 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 đánh giá so với thời gian hiện tại theo một cách 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 bài đá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 của bài đánh giá.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
flagContentUri

string

Đường liên kết để người dùng có thể gắn cờ một vấn đề liên quan đến bài đánh giá.
googleMapsUri

string

Đường liên kết để hiển thị bài đánh giá trên Google Maps.
visitDate

object (Date)

Ngày mà tác giả đến địa điểm. Giá trị này được rút gọn thành năm và tháng của lượt truy cập.

AuthorAttribution

Thông tin về tác giả của dữ liệu nội dung do người dùng tạo. Được 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ả Photo hoặc Review.
photoUri

string

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

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 quan trọng. Ngày này có liên quan đến Dương lịch. Nội dung này có thể đại diện cho một trong những nội dung 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, với giá trị năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0.
  • Năm và tháng, với giá trị ngày bằng 0 (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 từ 0 để chỉ định một 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ị trong năm và tháng, hoặc bằng 0 để chỉ định một năm hoặc một năm và tháng, trong đó ngày là không quan trọng.

OpeningHours

Thông tin về giờ hoạt động 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)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Trường
periods[]

object (Period)

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

Ngày bắt đầu của periods KHÔNG cố định và không được giả định là Chủ Nhật. API xác định ngày bắt đầu dựa trên nhiều yếu tố. Ví dụ: đối với một doanh nghiệp hoạt động 24/7, khoảng thời gian đầu tiên có thể bắt đầu vào ngày gửi yêu cầu. Đối với những doanh nghiệp khác, đó có thể là ngày đầu tiên trong tuần mà họ mở cửa.

LƯU Ý: Thứ tự của mảng periods không phụ thuộc vào thứ tự của mảng weekdayDescriptions. Đừng cho rằng các chiến dịch sẽ bắt đầu vào cùng một ngày.
weekdayDescriptions[]

string

Các chuỗi đã bản địa hoá mô tả giờ mở cửa của địa điểm này, mỗi chuỗi cho một ngày trong tuần.

LƯU Ý: Thứ tự của các ngày và ngày bắt đầu tuần được xác định theo ngôn ngữ và khu vực. Thứ tự của mảng periods không phụ thuộc vào thứ tự của mảng weekdayDescriptions. Đừng cho rằng các chiến dịch sẽ bắt đầu vào cùng một ngày.

Sẽ trống nếu không xác định được giờ hoặc không thể chuyển đổi thành văn bản bản địa hoá. Ví dụ: "Chủ Nhật: 18:00 – 6:00"
secondaryHoursType

enum (SecondaryHoursType)

Một chuỗi loại dùng để xác định loại giờ hoạt động 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 mà giờ mở cửa được trả về bao gồm. Ngày đặc biệt là những ngày có thể ảnh hưởng đến giờ hoạt động của một địa điểm, ví dụ: Ngày Giáng sinh. Đặt cho currentOpeningHours và currentSecondaryOpeningHours nếu có giờ mở cửa đặc biệt.
nextOpenTime

string (Timestamp format)

Lần tiếp theo khoảng thời gian giờ mở cửa hiện tại bắt đầu, tối đa là 7 ngày sau. Trường này chỉ được điền sẵn nếu khoảng thời gian mở cửa không hoạt động tại thời điểm phân phát yêu cầu.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
nextCloseTime

string (Timestamp format)

Lần tiếp theo khoảng thời gian mở cửa hiện tại kết thúc là trong vòng 7 ngày tới. Trường này chỉ được điền sẵn nếu khoảng thời gian mở cửa đang hoạt động tại thời điểm phân phát yêu cầu.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
openNow

boolean

Khoảng thời gian mở cửa có đang hoạt động hay không. Đối với giờ mở cửa thông thường và giờ mở cửa hiện tại, trường này cho biết địa điểm có mở cửa hay không. Đối với giờ mở cửa phụ và giờ mở cửa phụ hiện tại, trường này cho biết giờ phụ của địa điểm này có đang hoạt động hay không.

Khoảng thời gian

Khoảng thời gian mà địa điểm duy trì 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 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

Đ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 tế nằm ngoài khoảng thời gian mà chúng tôi sẵn sàng trả về, vì vậy, chúng tôi sẽ cắt bớt giờ về các ranh giới 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 có yêu cầu sẽ được trả về.
day

integer

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

integer

Giờ ở định dạng 24 giờ. Dao động từ 0 đến 23.
minute

integer

Phút. Dao động từ 0 đến 59.

SecondaryHoursType

Một loại dùng để xác định loại giờ hoạt động phụ.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Giá trị mặc định khi bạn không chỉ định loại giờ phụ.
DRIVE_THROUGH Giờ mở cửa của dịch vụ lái xe qua cho 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ờ mua 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 bữa sáng muộn.
PICKUP Giờ đến lấy hàng.
ACCESS Giờ mở cửa của 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 mà giờ mở cửa được trả về bao gồm. Ngày đặc biệt là những ngày có thể ảnh hưởng đến giờ hoạt động 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 diễn ra ngày đặc biệt này.

TimeZone

Biểu thị một múi giờ trong Cơ sở dữ liệu múi giờ của IANA.

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

string

Múi giờ trong Cơ sở dữ liệu múi giờ của IANA. Ví dụ: "America/New_York".
version

string

Không bắt buộc. Số phiên bản Cơ sở dữ liệu múi giờ IANA. Ví dụ: "2019a".

Ả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)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
Trường
name

string

Giá trị nhận dạng. Một thông tin tham chiếu đại diện cho ảnh địa điểm này. Bạn có thể dùng thông tin này để tra cứu lại ảnh địa điểm này (còn gọi là tên "tài nguyên" API: places/{placeId}/photos/{photo}).
widthPx

integer

Chiều rộng tối đa có thể sử dụng, tính bằng pixel.
heightPx

integer

Chiều cao tối đa có thể sử dụng, tính bằng pixel.
authorAttributions[]

object (AuthorAttribution)

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

string

Đường liên kết mà người dùng có thể dùng để báo cáo vấn đề về bức ảnh.
googleMapsUri

string

Đường liên kết để hiển thị ảnh trên Google Maps.

BusinessStatus

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

Enum
BUSINESS_STATUS_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
OPERATIONAL Cơ sở này đang hoạt động, nhưng không nhất thiết là đang 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 là không xác định hoặc không rõ.
PRICE_LEVEL_FREE Địa điểm này cung cấp dịch vụ miễn phí.
PRICE_LEVEL_INEXPENSIVE Địa điểm cung cấp dịch vụ với giá cả phải chăng.
PRICE_LEVEL_MODERATE Địa điểm cung cấp dịch vụ với giá vừa phải.
PRICE_LEVEL_EXPENSIVE Địa điểm cung cấp dịch vụ đắt tiền.
PRICE_LEVEL_VERY_EXPENSIVE Địa điểm cung cấp 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 của nhà cung cấp dữ liệu Địa điểm.
providerUri

string

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

PaymentOptions

Các phương 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 thẻ tín dụng làm phương thức thanh toán.
acceptsDebitCards

boolean

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

boolean

Địa điểm này 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 qua NFC.

ParkingOptions

Thông tin về các lựa chọn đỗ xe tại đị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

Nơi này có bãi đỗ xe miễn phí.
paidParkingLot

boolean

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

boolean

Nơi này có chỗ đỗ xe miễn phí trên đường.
paidStreetParking

boolean

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

boolean

Nơi này có dịch vụ đỗ xe.
freeGarageParking

boolean

Nơi này có gara đỗ xe miễn phí.
paidGarageParking

boolean

Nơi này có gara đỗ xe có tính phí.

SubDestination

Địa điểm phụ là những địa điểm cụ thể liên quan đến một địa điểm chính. Những địa điểm này cung cấp đích đến cụ thể hơn cho những người dùng đang tìm kiếm trong một địa điểm rộng lớn hoặc phức tạp, chẳng hạn như sân bay, công viên quốc gia, trường đại học hoặc sân vận động. Ví dụ: các điểm đến phụ tại một sân bay có thể bao gồm các nhà ga và bãi đỗ xe liên quan. Các điểm đến phụ trả về mã địa điểm và tên tài nguyên địa điểm. Bạn có thể sử dụng mã địa điểm và tên tài nguyên địa điểm trong các yêu cầu Chi tiết về địa điểm (Mới) tiếp theo để tìm nạp thông tin chi tiết phong phú hơn, bao gồm cả tên hiển thị và vị trí của điểm đến phụ.

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 lựa chọn hỗ trợ tiếp cận 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 này có chỗ đỗ xe cho xe lăn.
wheelchairAccessibleEntrance

boolean

Địa điểm có lối vào dành 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 loại nhiên liệu tại 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 đã biết gần đây nhất cho từng loại nhiên liệu mà trạm xăng này có. Mỗi loại nhiên liệu mà trạm xăng này có sẽ có một mục nhập. Thứ tự không quan trọng.

FuelPrice

Thông tin về giá nhiên liệu cho một loại nhiên liệu nhất định.

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 gian cập nhật gần đây nhất của giá nhiên liệu.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

FuelType

Các loại nhiên liệu.

Enum
FUEL_TYPE_UNSPECIFIED Loại nhiên liệu chưa được chỉ định.
DIESEL Dầu diesel.
DIESEL_PLUS Dầu diesel và nhiên liệu.
REGULAR_UNLEADED Xăng không chì thông thường.
MIDGRADE Loại trung.
PREMIUM Premium.
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 SP 100.
LPG Khí dầu mỏ hoá lỏng.
E80 E 80.
E85 E 85.
E100 E 100.
METHANE Khí methane.
BIO_DIESEL Dầu diesel sinh học.
TRUCK_DIESEL Dầu diesel cho xe tải.

Tiền

Biểu thị một số tiền cùng với 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 3 chữ cái được xác định trong ISO 4217.
units

string (int64 format)

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

integer

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

EVChargeOptions

Thông tin về Trạm sạc xe điện được lưu trữ trong Địa điểm. Thuật ngữ tuân theo https://afdc.energy.gov/fuels/electricity_infrastructure.html Mỗi cổng sạc 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 sạc.

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

integer

Số lượng đầu cắm tại trạm sạc 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ột ô tô tại một thời điểm (ví dụ: 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 các cụm đầu nối sạc xe điện chứa các đầu nối cùng loại và cùng tốc độ sạc.

ConnectorAggregation

Thông tin sạc xe điện được nhóm theo [type, maxChargeRateKw]. Cho biết thông tin tổng hợp về các đầu sạc xe điện 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ép tổng hợp này.
maxChargeRateKw

number

Tốc độ sạc tối đa tĩnh tính (tính bằng kW) của mỗi giắc cắm trong nhóm.
count

integer

Số lượng đầu nối trong tổ hợp này.
availabilityLastUpdateTime

string (Timestamp format)

Dấu thời gian khi thông tin về trạng thái sẵn có của trình kết nối trong thông tin tổng hợp này được cập nhật lần gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
availableCount

integer

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

integer

Số lượng giắc cắm trong cụm này hiện không sử dụng được.

EVConnectorType

Hãy xem 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 Giắc cắm không xác định.
EV_CONNECTOR_TYPE_OTHER Các loại giắc cắm khác.
EV_CONNECTOR_TYPE_J1772 Đầu cắm loại 1 J1772.
EV_CONNECTOR_TYPE_TYPE_2 Giắc cắm loại 2 theo tiêu chuẩn IEC 62196. Thường được gọi là MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Đầu cắm 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 đầu cắm 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 ở những nơi khác trên thế giới (ví dụ: CCS Combo 2 (CCS2) hoặc GB/T). Giá trị này ít đại diện cho một loại giắc cắm thực tế hơn và đại diện nhiều hơn cho khả năng sạc xe của thương hiệu Tesla tại một 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 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.
EV_CONNECTOR_TYPE_NACS Hệ thống sạc Bắc Mỹ (NACS), được tiêu chuẩn hoá thành SAE J3400.

GenerativeSummary

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

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

object (LocalizedText)

Thông tin tổng quan về địa điểm.
overviewFlagContentUri

string

Đường liên kết mà người dùng có thể gắn cờ một vấn đề với bản tóm tắt tổng quan.
disclosureText

object (LocalizedText)

Thông báo công bố về AI "Tóm tắt bằng Gemini" (và các phiên bản được bản địa hoá). Nếu có, thông tin này sẽ có bằng ngôn ngữ được chỉ định trong yêu cầu.

ContainingPlace

Thông tin về địa điểm mà địa điểm này nằm trong đó.

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 địa điểm nơi có địa điểm này.
id

string

Mã địa điểm của địa điểm chứa địa điểm này.

AddressDescriptor

Nội dung mô tả quan hệ về một vị trí. Bao gồm một tập hợp được xếp hạng gồm các địa danh lân cận và các khu vực chứa chính xác cũng như mối quan hệ của các khu vực này với vị trí mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Trường
landmarks[]

object (Landmark)

Danh sách được xếp hạng các địa danh lân cận. Những địa danh dễ nhận biết nhất và ở gần nhất sẽ được xếp hạng đầu tiên.
areas[]

object (Area)

Danh sách xếp hạng các khu vực chứa hoặc lân cận. Những khu vực dễ nhận biết và chính xác nhất sẽ được xếp hạng đầu tiên.

Địa danh

Thông tin cơ bản về địa danh và mối quan hệ giữa địa danh với vị trí mục tiêu.

Địa điểm nổi bật là những địa điểm dễ nhận biết có thể dùng để mô tả một vị trí.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Trường
name

string

Tên tài nguyên của địa danh.
placeId

string

Mã địa điểm của địa danh.
displayName

object (LocalizedText)

Tên hiển thị của địa danh.
types[]

string

Một tập hợp các thẻ loại cho địa danh này. Để xem danh sách đầy đủ các giá trị có thể có, hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/place-types.
spatialRelationship

enum (SpatialRelationship)

Xác định mối quan hệ không gian giữa vị trí mục tiêu và địa danh.
straightLineDistanceMeters

number

Khoảng cách theo đường thẳng (tính bằng mét) giữa tâm của mục tiêu và tâm của địa điểm. Trong một số trường hợp, giá trị này có thể lớn hơn travelDistanceMeters.
travelDistanceMeters

number

Khoảng cách di chuyển (tính bằng mét) dọc theo mạng lưới đường bộ từ mục tiêu đến địa danh (nếu có). Giá trị này không tính đến phương thức di chuyển, chẳng hạn như đi bộ, lái xe hoặc đi xe đạp.

SpatialRelationship

Xác định mối quan hệ không gian giữa vị trí mục tiêu và địa danh.

Enum
NEAR Đây là mối quan hệ mặc định khi không có mối quan hệ nào cụ thể hơn bên dưới được áp dụng.
WITHIN Địa điểm có hình học không gian và mục tiêu nằm trong phạm vi của địa điểm đó.
BESIDE Mục tiêu nằm ngay bên cạnh địa danh.
ACROSS_THE_ROAD Mục tiêu nằm ngay đối diện với địa danh ở phía bên kia đường.
DOWN_THE_ROAD Trên cùng tuyến đường với địa danh nhưng không phải bên cạnh hoặc đối diện.
AROUND_THE_CORNER Không nằm trên cùng tuyến đường với địa danh nhưng chỉ cách một ngã rẽ.
BEHIND Gần cấu trúc của địa danh nhưng ở xa lối vào từ đường phố.

Khu vực

Thông tin về khu vực và mối quan hệ giữa khu vực đó với vị trí mục tiêu.

Khu vực bao gồm tiểu khu, khu dân cư và khu vực rộng lớn chính xác, hữu ích cho việc mô tả một vị trí.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Trường
name

string

Tên tài nguyên của khu vực.
placeId

string

Mã địa điểm của khu vực.
displayName

object (LocalizedText)

Tên hiển thị của khu vực.
containment

enum (Containment)

Xác định mối quan hệ không gian giữa vị trí mục tiêu và khu vực.

Vùng chứa

Xác định mối quan hệ không gian giữa vị trí mục tiêu và khu vực.

Enum
CONTAINMENT_UNSPECIFIED Chưa xác định phạm vi chứa.
WITHIN Vị trí mục tiêu nằm trong khu vực, gần với trung tâm.
OUTSKIRTS Vị trí mục tiêu nằm trong vùng khu vực, gần với rìa.
NEAR Vị trí mục tiêu nằm ngoài khu vực nhưng ở gần đó.

PriceRange

Phạm vi giá liên kết với một Địa điểm. Bạn có thể huỷ đặt endPrice. Điều này cho biết một dải ô không có giới hạn trên (ví dụ: "Lớn hơn 1.000.000 VND").

Biểu diễn dưới dạng JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Trường
startPrice

object (Money)

Mức giá thấp nhất của phạm vi giá (bao gồm). Giá phải bằng hoặc cao hơn số tiền này.
endPrice

object (Money)

Mức giá cao nhất của dải giá (không bao gồm). Giá phải thấp hơn số tiền này.

ReviewSummary

Bản tóm tắt do AI tạo về địa điểm dựa trên bài đánh giá của người dùng.

Biểu diễn dưới dạng JSON 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
Trường
text

object (LocalizedText)

Tóm tắt bài đánh giá của người dùng.
flagContentUri

string

Đường liên kết mà người dùng có thể gắn cờ vấn đề với nội dung tóm tắt.
disclosureText

object (LocalizedText)

Thông báo công bố về AI "Tóm tắt bằng Gemini" (và các phiên bản được bản địa hoá). Nếu có, thông tin này sẽ có bằng ngôn ngữ được chỉ định trong yêu cầu.
reviewsUri

string

Một đường liên kết để xem các bài đánh giá về địa điểm này trên Google Maps.

EvChargeAmenitySummary

Thông tin tóm tắt về các tiện nghi gần trạm sạc xe điện. Điều này chỉ áp dụng cho những địa điểm có loại electric_vehicle_charging_station. Trường overview chắc chắn sẽ được cung cấp, trong khi các trường khác là không bắt buộc.

Biểu diễn dưới dạng JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Trường
overview

object (ContentBlock)

Tổng quan về các tiện nghi có sẵn. Chúng tôi đảm bảo sẽ cung cấp thông tin này.
coffee

object (ContentBlock)

Tóm tắt các lựa chọn về quán cà phê ở gần.
restaurant

object (ContentBlock)

Tóm tắt về các nhà hàng gần đó.
store

object (ContentBlock)

Thông tin tóm tắt về các cửa hàng gần đây.
flagContentUri

string

Đường liên kết mà người dùng có thể gắn cờ vấn đề với nội dung tóm tắt.
disclosureText

object (LocalizedText)

Thông báo công bố về AI "Tóm tắt bằng Gemini" (và các phiên bản được bản địa hoá). Nếu có, thông tin này sẽ có bằng ngôn ngữ được chỉ định trong yêu cầu.

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 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
Trường
content

object (LocalizedText)

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

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.

NeighborhoodSummary

Tóm tắt các địa điểm yêu thích ở gần nơi đó.

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

object (ContentBlock)

Tóm tắt tổng quan về khu vực lân cận.
description

object (ContentBlock)

Nội dung mô tả chi tiết về khu vực lân cận.
flagContentUri

string

Đường liên kết mà người dùng có thể gắn cờ vấn đề với nội dung tóm tắt.
disclosureText

object (LocalizedText)

Thông báo công bố về AI "Tóm tắt bằng Gemini" (và các phiên bản được bản địa hoá). Nếu có, thông tin này sẽ có bằng ngôn ngữ được chỉ định trong yêu cầu.

ConsumerAlert

Thông báo cảnh báo người tiêu dùng cho địa điểm khi chúng tôi phát hiện thấy hoạt động đánh giá đáng ngờ về một doanh nghiệp hoặc khi một doanh nghiệp vi phạm chính sách của chúng tôi.

Biểu diễn dưới dạng JSON 
{
  "overview": string,
  "details": {
    object (Details)
  },
  "languageCode": string
}
Trường
overview

string

Thông tin tổng quan về thông báo cảnh báo cho người dùng.
details

object (Details)

Thông tin chi tiết về thông báo cảnh báo cho người tiêu dùng.
languageCode

string

Mã ngôn ngữ của thông báo cảnh báo dành cho người tiêu dùng. Đây là mã ngôn ngữ BCP 47.

Thông tin chi tiết

Thông tin chi tiết về thông báo cảnh báo cho người tiêu dùng.

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "description": string,
  "aboutLink": {
    object (Link)
  }
}
Trường
title

string

Tiêu đề sẽ xuất hiện cùng với nội dung mô tả.
description

string

Nội dung mô tả về thông báo cảnh báo cho người tiêu dùng.

Phương thức

autocomplete

 Trả về các dự đoán cho dữ liệu đầu vào đã cho.

get

 Nhận 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 đó. Đây là một chuỗi ở định dạng places/{place_id}.

searchNearby

 Tìm kiếm địa điểm gần vị trí.

searchText

 Tìm kiếm địa điểm dựa trên cụm từ tìm kiếm bằng văn bản.