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)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "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, ở định dạng places/{placeId}. Có thể 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 với nội dung mô tả ngắn gọn và dễ đọc. Ví dụ: "Google Sydney", "Starbucks", "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". Để 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 các loại được hỗ trợ của 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. Để 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á theo 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 của địa điểm ở định dạng quốc gia, dễ đọc.
internationalPhoneNumber

string

Số điện thoại của địa điểm ở định dạng quốc tế, dễ đọc.
formattedAddress

string

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

string

Địa chỉ ngắn, dễ đọc cho địa điểm này.
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 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 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ý đảo ngược, truyền vĩ độ/kinh độ của địa chỉ dưới dạng 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 thay đổi tuỳ theo đị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 này.
plusCode

object (PlusCode)

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

object (LatLng)

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

object (Viewport)

Khung nhìn 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 nhìn này làm ranh giới thực tế hoặc khu vực phục vụ 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

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

string

Trang web có thẩm quyền về địa điểm này, ví dụ: trang chủ của doanh nghiệp. Xin lưu ý rằng đối với những địa điểm thuộc một chuỗi cửa hàng (ví dụ: cửa hàng IKEA), đây thường là trang web của từng cửa hàng chứ không phải của toàn bộ chuỗi cửa hàng.
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. Ứng dụng có thể dựa vào trạng thái luôn mở (24 giờ) được biểu thị dưới dạng khoảng thời gian [open][google.foo.OpeningHours.Period.open] chứa [day][google.foo.Point.day] có giá trị 0, [hour][google.foo.Point.hour] có giá trị 0 và [minute][google.foo.Point.minute] có giá trị 0.
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. Bạn có thể trả lại tối đa 10 ả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 tập hợp nhà cung cấp dữ liệu phải hiển thị cùng với kết quả này.
iconMaskBaseUri

string

URL bị cắt bớt đến 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ờ hoạt động trong 7 ngày tới (kể cả hôm nay). Khoảng thời gian này bắt đầu lúc nửa đêm vào ngày bạn 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ả giờ, được đặt cho những ngày có giờ đặc biệt.
currentSecondaryOpeningHours[]

object (OpeningHours)

Chứa một mảng các mục nhập 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àm giờ hoạt động phụ. Trường này điền sẵn trường phụ type (loại). Trường này lấy từ danh sách các loại giờ mở cửa được xác định trước (chẳng hạn như DRIVE_THROUGH, PICKUP hoặc TAKEOUT) dựa trên loại địa điểm. Trường này bao gồm trường con specialDays của tất cả giờ, được đặt cho những ngày có giờ đặc biệt.
regularSecondaryOpeningHours[]

object (OpeningHours)

Chứa một mảng các mục nhập cho thông tin về giờ hoạt động phụ thông thường 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àm giờ hoạt động phụ. Trường này điền sẵn trường phụ type (loại). Trường này lấy từ danh sách các loại giờ mở cửa được xác định trước (chẳng hạn như DRIVE_THROUGH, PICKUP hoặc TAKEOUT) 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. Tóm tắt bao gồm nội dung tổng quan dạng văn bản và cũng bao gồm mã ngôn ngữ cho các 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 đượ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ề phương thức thanh toán, trường phương thức 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 đích đế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)

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

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

object (AreaSummary)

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Bản tóm tắt do AI tạo về khu vực nơi địa điểm đó tọa lạc.
containingPlaces[]

object (ContainingPlace)

Danh sách các địa điểm nơi địa điểm hiện tại tọa lạc.
addressDescriptor

object (AddressDescriptor)

Chỉ số mô tả địa chỉ của địa điểm. Thông tin mô tả địa chỉ bao gồm thông tin bổ sung giúp mô tả một vị trí bằng các địa danh và khu vực. Xem phạm vi cung cấp tính năng mô tả địa chỉ theo khu vực 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.
utcOffsetMinutes

integer

Số phút múi giờ của địa điểm này hiện chênh lệch so với UTC. Giá trị này được thể hiện bằng phút để hỗ trợ các múi giờ bị chênh lệch theo phần của 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ợ dịch vụ mang đi hay không.
delivery

boolean

Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ giao hàng hay không.
dineIn

boolean

Chỉ định xem doanh nghiệp có hỗ trợ 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ụ đến lấy hàng tại lề đường hay không.
reservable

boolean

Chỉ định xem đị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 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 đó 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 này có chỗ ngồi ngoài trời.
liveMusic

boolean

Địa điểm này có chương trình 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 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 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 phù hợp với các nhóm.
goodForWatchingSports

boolean

Địa điểm phù hợp để xem các trận đấu 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 cung cấp dịch vụ tại cơ sở khách hàng hay không. Doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng là một 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ỉ của 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ể đã 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 đã 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ỉ đượ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 đủ 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 văn bản viết tắt 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 thành phần địa chỉ.
languageCode

string

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

PlusCode

Plus code (http://plus.codes) là một tọa độ tham chiếu vị trí có hai định dạng: mã toàn cầu xác định hình chữ nhật 14mx14m (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 một khu vực có kích thước 1/8000 độ x 1/8000 độ (~14 x 14 mét).
compoundCode

string

Mã hợp chất 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 được định dạng của một thực thể tham chiếu.

LatLng

Một đối tượng đại diện cho một cặp vĩ độ/kinh độ. Giá trị này được biểu thị dưới dạng một cặp số thực để thể hiện 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 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

Chế độ xem vĩ độ-kinh độ, được biểu thị dưới dạng hai điểm low và high đối diện nhau theo đường chéo. Khung nhìn được coi là một vùng kín, tức là bao gồm cả ranh giới. 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 sẽ bao gồm một điểm duy nhất đó.

  • Nếu low.longitude > high.longitude, thì dải kinh độ sẽ bị đảo ngược (khung nhìn sẽ cắt ngang đườ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ì dải kinh độ sẽ trống.

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

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

Ví dụ: khung nhìn này bao gồm toàn bộ 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.

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
}
Trường
name

string

Một tệp tham chiếu đại diện cho bài đánh giá địa điểm này. Bạn có thể dùng tệp này để tra cứu lại bài đánh giá địa điểm này (còn gọi là tên "tài nguyên" của 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 ở một 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)

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 gọi là số lượng 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 ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
flagContentUri

string

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

string

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

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 của tác giả 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.

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, bắt đầu từ Chủ Nhật 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ụ: vì địa điểm đó tạm thời đóng cửa để tu sửa.
weekdayDescriptions[]

string

Chuỗi đã bản địa hoá mô tả giờ mở cửa của địa điểm này, mỗi ngày trong tuần có một chuỗi. 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–06:00"
secondaryHoursType

enum (SecondaryHoursType)

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 các ngày đặc biệt nằm trong khoảng thời gian mà giờ mở cửa được trả về. 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ờ làm việc đặc biệt.
nextOpenTime

string (Timestamp format)

Thời điểm tiếp theo mà khoảng thời gian giờ mở cửa hiện tại bắt đầu, tối đa là 7 ngày trong tương lai. Trường này chỉ được điề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.

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

string (Timestamp format)

Thời điểm tiếp theo mà khoảng thời gian giờ mở cửa hiện tại kết thúc, tối đa là 7 ngày trong tương lai. Trường này chỉ được điề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.

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

boolean

Khoảng thời gian mở cửa hiện có hiệu lực 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 liệu đị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 liệu giờ mở cửa 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 đị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 điể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. 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 ta muốn trả về giờ, vì vậy, chúng ta sẽ cắt bớt giờ về các ranh giới này. Điều này đảm bảo rằng hệ thống sẽ trả về kết quả trong vòng tối đa 24 * 7 giờ kể từ nửa đêm của ngày nhận được yêu cầu.
day

integer

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ờ theo định dạng 24 giờ. Dao động từ 0 đến 23.
minute

integer

Phút. Phạm vi từ 0 đế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 quan trọng. Ngày này có liên quan đến Lịch Gregorian. Giá trị này có thể biểu thị 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 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 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 bằng 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 giá trị năm, hoặc một năm và tháng, trong đó ngày là 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 bạn không chỉ định loại giờ phụ.
DRIVE_THROUGH Giờ phục vụ tại quầy thanh toán tự động 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 sáng muộn.
PICKUP Giờ đến lấy hàng.
ACCESS Giờ truy cập vào 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 các ngày đặc biệt nằm trong khoảng thời gian mà giờ mở cửa được trả về. 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 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)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
Trường
name

string

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

integer

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

integer

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

object (AuthorAttribution)

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

string

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

string

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

BusinessStatus

Trạng thái kinh doanh 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, nhưng không nhất thiết phải mở cửa ngay.
CLOSED_TEMPORARILY Cơ sở này 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 chỉ định hoặc không xác định.
PRICE_LEVEL_FREE Địa điểm cung cấp dịch vụ miễn phí.
PRICE_LEVEL_INEXPENSIVE Địa điểm cung cấp các dịch vụ giá rẻ.
PRICE_LEVEL_MODERATE Địa điểm cung cấp các dịch vụ có mức giá vừa phải.
PRICE_LEVEL_EXPENSIVE Địa điểm cung cấp các dịch vụ đắt đỏ.
PRICE_LEVEL_VERY_EXPENSIVE Địa điểm này cung cấp các dịch vụ rất đắt đỏ.

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 của Đị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 này chấp nhận thanh toán bằng thẻ tín dụng.
acceptsDebitCards

boolean

Địa điểm này chấp nhận thanh toán bằng thẻ ghi 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

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

boolean

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

boolean

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

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

boolean

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

boolean

Địa điểm này có gara đỗ xe có tính phí.

SubDestination

Tên tài nguyên và mã của các đích đến phụ liên quan đến địa điểm. Ví dụ: các ga là các đích đế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ợ 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 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 gần đây nhất được biết đến 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á 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, có độ phân giải nano giây và tối đa 9 chữ số thập phân. 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 không xác định.
DIESEL Dầu diesel.
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 Bản vá bảo mật 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 100 peso Chile.
LPG LPG.
E80 E 80.
E85 E 85.
METHANE Khí mêtan.
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ã tiền tệ gồm ba chữ cái được xác định trong ISO 4217.
units

string (int64 format)

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. Nếu units dương, nanos phải dương hoặc bằng 0. Nếu units bằng 0, nanos có thể là số dương, 0 hoặc số âm. Nếu units âm, thì nanos phải âm hoặc bằng 0. Ví dụ: -1,75 đô la đượ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 có thể sạc một xe ô tô tại một thời điểm. Một cổng có một hoặc nhiều đầu nối. 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 đầu nối tại trạm này. Tuy nhiên, do một số cổng có thể có nhiều đầu nối nhưng chỉ có thể sạc một ô tô tại một thời điểm (ví dụ:), số lượng đầu nối 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ập hợp đầ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 thấy thông tin tổng hợp về việc sạc xe điện của các đầu nối 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 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ủa lần cập nhật gần đây nhất đối với thông tin về tình trạng hoạt động của trình kết nối trong dữ liệu tổng hợp này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. 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 trong dữ liệu tổng hợp này hiện có.
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 xem http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 để biết thêm thông tin/thông tin chi tiết về các loại đầu nối 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 đầu nối khác.
EV_CONNECTOR_TYPE_J1772 Đầu nối J1772 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 Đầu 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 J-1772 loại 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Hệ thống sạc kết hợp (AC và DC). Dựa trên đầu 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 khu vực khác trên thế giới (ví dụ: CCS Combo 2 (CCS2) hoặc GB/T). Giá trị này ít thể hiện loại đầu nối thực tế hơn và thể hiện khả năng sạc xe mang 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 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.

GenerativeSummary

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

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,
  "description": {
    object (LocalizedText)
  },
  "descriptionFlagContentUri": string,
  "references": {
    object (References)
  }
}
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ờ vấn đề kèm theo thông tin tóm tắt tổng quan.
description

object (LocalizedText)

Nội dung mô tả chi tiết về địa điểm.
descriptionFlagContentUri

string

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

object (References)

Các tệp đối chiếu được dùng để tạo nội dung mô tả tóm tắt.

Tài liệu tham khảo

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Nội dung tham chiếu 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)

Bài đánh giá đóng vai trò là tài liệu tham khảo.
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ể sử 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: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

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

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

object (ContentBlock)

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

string

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

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: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Nội dung tham chiếu liên quan đến khối nội dung này.

ContainingPlace

Thông tin về vị trí của địa điểm này.

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 địa điểm này tọa lạc.
id

string

Mã địa điểm của địa điểm nơi địa điểm này tọa lạc.

AddressDescriptor

Nội dung mô tả quan hệ về một vị trí. Bao gồm một tập hợp các địa danh lân cận và khu vực chứa chính xác được xếp hạng cùng mối quan hệ của các địa danh đó 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 địa danh lân cận được xếp hạng. Những địa danh nổi tiếng và gần nhất được xếp hạng đầu tiên.
areas[]

object (Area)

Danh sách được xếp hạng gồm các khu vực chứa hoặc liền kề. Những khu vực dễ nhận biết và chính xác nhất sẽ được xếp hạng trước.

Địa danh

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

Cây cầu là những địa điểm nổi bậ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 thẻ loại cho địa danh này. Để xem danh sách đầy đủ các giá trị có thể có, hãy xem 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à điểm đánh dấu.
straightLineDistanceMeters

number

Khoảng cách theo đường thẳng, tính bằng mét, giữa điểm giữa của mục tiêu và điểm giữa của điểm đánh dấu. Trong một số trường hợp, giá trị này có thể dài 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 từ mục tiêu đến điểm mốc (nếu có). Giá trị này không tính đến phương tiện 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à điểm đánh dấu.

Enum
NEAR Đây là mối quan hệ mặc định khi không có mối quan hệ cụ thể nào khác áp dụng ở bên dưới.
WITHIN Điểm đánh dấu có hình học không gian và mục tiêu nằm trong giới hạn của điểm đánh dấu.
BESIDE Mục tiêu nằm ngay cạnh điểm đánh dấu.
ACROSS_THE_ROAD Mục tiêu nằm ngay đối diện với điểm mốc ở phía bên kia đường.
DOWN_THE_ROAD Trên cùng một tuyến đường với địa điểm yêu thích, 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 điểm yêu thích 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 đường phố.

Khu vực

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

Khu vực bao gồm các địa phương phụ, khu dân cư và khu phức hợp 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 vùng chứa.
WITHIN Vị trí mục tiêu nằm trong khu vực, gần trung tâm.
OUTSKIRTS Vị trí mục tiêu nằm trong vùng, gần cạnh.
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ể không đặt endPrice, cho biết một dải ô không có giới hạn trên (ví dụ: "Trên 100 đô la").

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 trong khoảng 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 khoảng giá (không bao gồm). Giá phải thấp hơn số tiền này.

Phương thức

autocomplete

 Trả về kết quả 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 đó, tên này là một chuỗi ở định dạng places/{place_id}.

searchNearby

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

searchText

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