Package google.maps.places.v1

Landmark

附近地標的排序清單。系統會優先顯示最容易辨識的附近地標。

Area

包含或相鄰區域的排名清單。系統會優先顯示最容易辨識且最精確的區域。

string

區域的資源名稱。

string

該區域的地點 ID。

LocalizedText

區域的顯示名稱。

Containment

定義目標位置與區域之間的空間關係。

string

地標的資源名稱。

string

地標的地點 ID。

LocalizedText

地標的顯示名稱。

string

這個地標的一組類型標記。如需可能值的完整清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types。

SpatialRelationship

定義目標位置與地標之間的空間關係。

float

目標中心點與地標中心點之間的直線距離 (以公尺為單位)。在某些情況下，這個值可能會大於 travel_distance_meters。

float

從目標到地標的道路網路距離 (以公尺為單位，如已知)。這項值不會考量交通方式，例如步行、開車或騎單車。

string

Photo 或 Review 的作者姓名。

string

Photo 或 Review 的作者 URI。

string

Photo 或 Review 作者的個人資料相片 URI。

string

必要欄位。要搜尋的文字字串。

LocationBias

(選用步驟) 針對指定地點調整結果。

最多只能設定 location_bias 或 location_restriction 其中一個。如果兩者皆未設定，系統會根據 IP 位址調整結果，也就是將 IP 位址對應至不精確的位置，並做為調整信號。

LocationRestriction

(選用步驟) 將結果限制在指定地點。

最多只能設定 location_bias 或 location_restriction 其中一個。如果兩者皆未設定，系統會根據 IP 位址調整結果，也就是將 IP 位址對應至不精確的位置，並做為調整信號。

string

(選用步驟) 地點類型 (https://developers.google.com/maps/documentation/places/web-service/place-types) 中包含的主要地點類型 (例如「restaurant」或「gas_station」)，或僅 (regions)，或僅 (cities)。只有當地點的主要類型包含在這份清單中時，系統才會傳回該地點。最多可指定 5 個值。如未指定類型，系統會傳回所有地點類型。

string

(選用步驟) 只納入指定地區的結果，最多可指定 15 個 CLDR 雙字元地區代碼。空集合不會限制結果。如果同時設定 location_restriction 和 included_region_codes，結果會位於交集區域。

string

(選用步驟) 傳回結果時使用的語言。預設為「en-US」。如果 input 中使用的語言與 language_code 不同，或傳回的地點沒有從當地語言到 language_code 的翻譯，結果可能會以混合語言顯示。

string

(選用步驟) 區碼，指定為 CLDR 雙字元區碼。這會影響地址格式、結果排名，以及可能影響傳回的結果。這不會將結果限制在指定區域。如要將結果限制在特定地區，請使用 region_code_restriction。

LatLng

(選用步驟) 計算到目的地 (以 distance_meters 形式傳回) 的測地距離時，使用的原點。如果省略這個值，系統就不會傳回測地距離。

int32

(選用步驟) 以零為基準的 Unicode 字元位移值 input，表示 input 中的游標位置。游標位置可能會影響系統傳回的預測結果。

如果為空白，則預設為 input 的長度。

bool

(選用步驟) 如果為 true，回應會同時包含地點和查詢預測。否則回應只會傳回地點預測結果。

string

(選用步驟) 用於識別 Autocomplete 工作階段的字串，以利計費。必須是網址和檔案名稱安全 Base64 字串，長度最多為 36 個 ASCII 字元。否則會傳回 INVALID_ARGUMENT 錯誤。

工作階段是從使用者輸入查詢時開始，到使用者選取地點並呼叫 Place Details 或 Address Validation 時結束。在每個工作階段中，使用者可以輸入多筆查詢，最終提出一項 Place Details 或 Address Validation 要求。工作階段中每項要求使用的憑證，都必須屬於同一個 Google Cloud 控制台專案。工作階段結束後，符記就會失效。您的應用程式必須為每個工作階段產生新的符記。如果省略 session_token 參數或重複使用工作階段符記，系統會視為未提供工作階段符記，並針對工作階段收費 (每個要求分別收費)。

建議遵循下列準則：

• 在所有 Place Autocomplete 呼叫中使用工作階段符記。
• 為每個工作階段產生新的符記。建議使用第 4 版 UUID。
• 請確保工作階段內所有 Place Autocomplete、Place Details 和 Address Validation 要求使用的憑證，都屬於同一個 Cloud 控制台專案。
• 請務必針對每個新的工作階段傳遞不重複的工作階段符記。如果多個工作階段使用同一個符記，則每個要求會分別計費。

bool

(選用步驟) 如果欄位設為 true，請加入純服務範圍商家。純區域服務商家是指提供到府服務或直接送貨給顧客的商家，不在商家地址服務顧客。例如清潔或水電服務。這些商家在 Google 地圖上沒有實體地址或位置。對於這類商家，Places 不會傳回 location、plus_code 和其他地點相關欄位。

Viewport

由東北角和西南角定義的檢視區塊。

Circle

以中心點和半徑定義的圓形。

Viewport

由東北角和西南角定義的檢視區塊。

Circle

以中心點和半徑定義的圓形。

Suggestion

包含建議清單，並依關聯性遞減排序。

PlacePrediction

地點的預測結果。

QueryPrediction

查詢的預測結果。

string

可直接使用或以 matches 格式化的文字。

StringRange

字串範圍清單，用於識別輸入要求在 text 中相符的位置。這些範圍可用於格式化 text 的特定部分。如果系統是根據字串比對以外的條件 (例如拼寫校正或音譯) 判斷是否相符，子字串可能不會與 input 完全相符。

這些值是 text 的 Unicode 字元偏移。系統保證範圍會依遞增的位移值排序。

string

建議地點的資源名稱。這個名稱可用於接受地點名稱的其他 API。

string

建議地點的專屬 ID。這個 ID 可用於接受地點 ID 的其他 API。

FormattableText

包含傳回結果的使用者可解讀名稱。如果是機構結果，通常會顯示商家名稱和地址。

建議想顯示單一 UI 元素的開發人員使用 text。如果開發人員想顯示兩個獨立但相關的 UI 元素，可以改用 structured_format。這兩種方式代表的地點預測結果不同。使用者不應嘗試剖析 structured_format 為 text，反之亦然。

這段文字可能與 GetPlace 傳回的 display_name 不同。

如果要求 input 和 language_code 使用不同語言，或地點沒有從當地語言到 language_code 的翻譯，則可能以混合語言顯示。

StructuredFormat

地點預測會細分為主要文字 (包含地點名稱) 和次要文字 (包含其他消歧特徵，例如城市或區域)。

如果開發人員想顯示兩個獨立但相關的 UI 元素，建議使用 structured_format。如要顯示單一 UI 元素，開發人員可以改用 text。這兩種方式代表的地點預測結果不同。使用者不應嘗試剖析 structured_format 為 text，反之亦然。

string

適用於這個地點的類型清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types 的表 A 或表 B。

類型是地點的分類。類型相同的地點會具有相似特徵。

int32

如果指定 origin，則為從 origin 開始的測地線長度 (以公尺為單位)。部分預測結果 (例如路線) 可能不會填入這個欄位。

FormattableText

預測文字。這段文字並非代表地點，而是可用於搜尋端點 (例如 Text Search) 的文字查詢。

建議想顯示單一 UI 元素的開發人員使用 text。如果開發人員想顯示兩個獨立但相關的 UI 元素，可以改用 structured_format。這兩種方式都能代表查詢預測。使用者不應嘗試剖析 structured_format 為 text，反之亦然。

如果要求 input 和 language_code 使用不同語言，或查詢的部分內容沒有從當地語言到 language_code 的翻譯，則可能使用混合語言。

StructuredFormat

查詢預測的細目，包括含有查詢內容的主要文字，以及含有其他消歧特徵 (例如城市或區域) 的次要文字。

如果開發人員想顯示兩個獨立但相關的 UI 元素，建議使用 structured_format。如要顯示單一 UI 元素，開發人員可以改用 text。這兩種方式都能代表查詢預測。使用者不應嘗試剖析 structured_format 為 text，反之亦然。

int32

字串第一個 Unicode 字元的位移值 (從零算起，含該字元)。

int32

最後一個 Unicode 字元的以零為準的位移 (不含)。

FormattableText

代表地點或查詢的名稱。

FormattableText

代表其他消歧特徵 (例如城市或區域)，可進一步識別地點或修正查詢。

LatLng

必要欄位。中心經緯度。

緯度範圍必須介於 [-90.0, 90.0] 之間。經度範圍必須介於 [-180.0, 180.0] 之間。

double

必要欄位。半徑 (以公尺為單位)。半徑必須介於 [0.0, 50000.0] 之間。

LocalizedText

與主題相關的內容。

string

所參照地點的資源名稱清單。這個名稱可用於接受地點資源名稱的其他 API。

Review

這個地點的評論清單，與地點查詢相關。

Photo

這個地點的相片相關資訊 (包括參照)，與地點查詢相關。

Justification

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

地點的說明。

ReviewJustification

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

BusinessAvailabilityAttributesJustification

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

bool

地點是否提供外帶服務。

bool

商家是否提供外送服務。

bool

地點是否提供內用服務。

HighlightedText

Review

系統用來生成醒目顯示文字的評論。

string

HighlightedTextRange

醒目顯示文字的範圍清單。

int32

int32

int32

這個充電站的充電器數量。不過，由於部分充電埠可能有多個接頭，但一次只能為一輛車充電 (例如)，因此接頭數量可能會大於可同時充電的車輛總數。

ConnectorAggregation

電動車充電接頭匯總清單，包含相同類型和相同充電速率的接頭。

EVConnectorType

這個匯總的連接器類型。

double

匯總中每個接頭的靜態最大充電速率 (以千瓦為單位)。

int32

這個匯總中的連接器數量。

Timestamp

上次更新這個彙整資料中連接器可用性資訊的時間戳記。

int32

這個彙整中目前可用的連接器數量。

int32

這個彙整中目前無法使用的連接器數量。

FuelPrice

加油站提供的每種燃料的最後已知價格。每個加油站的燃油類型各有一筆資料。順序並不重要。

FuelType

燃料類型。

Money

燃料價格。

Timestamp

上次更新油價的時間。

string

必要欄位。相片媒體的資源名稱，格式為 places/{place_id}/photos/{photo_reference}/media。

地點物件 photos.name 欄位中傳回的相片資源名稱格式為 places/{place_id}/photos/{photo_reference}。您需要在相片資源結尾附加 /media，才能取得相片媒體資源名稱。

int32

(選用步驟) 指定圖片的寬度上限 (以像素為單位)。如果圖片小於指定值，系統會傳回原始圖片。如果圖片任一維度較大，系統會縮放圖片，使較小的維度符合限制，並保留原始顯示比例。max_height_px 和 max_width_px 屬性都接受介於 1 到 4800 之間的整數 (含 1 和 4800)。如果值超出允許範圍，系統會傳回 INVALID_ARGUMENT 錯誤。

至少須指定 max_height_px 或 max_width_px。如果未指定 max_height_px 和 max_width_px，系統會傳回 INVALID_ARGUMENT 錯誤。

int32

(選用步驟) 指定圖片的高度上限 (以像素為單位)。如果圖片小於指定值，系統會傳回原始圖片。如果圖片任一維度較大，系統會縮放圖片，使較小的維度符合限制，並保留原始顯示比例。max_height_px 和 max_width_px 屬性都接受介於 1 到 4800 之間的整數 (含 1 和 4800)。如果值超出允許範圍，系統會傳回 INVALID_ARGUMENT 錯誤。

至少須指定 max_height_px 或 max_width_px。如果未指定 max_height_px 和 max_width_px，系統會傳回 INVALID_ARGUMENT 錯誤。

bool

(選用步驟) 如果已設定，請略過預設的 HTTP 重新導向行為，並以文字格式 (例如 HTTP 用途的 JSON 格式) 呈現回應。如果未設定，系統會發出 HTTP 重新導向，將呼叫重新導向至圖片媒體。非 HTTP 要求會忽略這個選項。

string

必要欄位。地點的資源名稱，格式為 places/{place_id}。

string

(選用步驟) 如果地點詳細資料有提供偏好語言版本，系統就會顯示該版本。

目前支援的語言清單：https://developers.google.com/maps/faq#languagesupport。

string

(選用步驟) 要求來源位置的 Unicode 國家/地區代碼 (CLDR)。這個參數用於顯示地點詳細資料，例如特定區域的地點名稱 (如有)。根據適用法律，這項參數可能會影響結果。詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

請注意，系統目前不支援 3 位數的區域代碼。

string

(選用步驟) 用於識別 Autocomplete 工作階段的字串，以利計費。必須是網址和檔案名稱安全 Base64 字串，長度最多為 36 個 ASCII 字元。否則會傳回 INVALID_ARGUMENT 錯誤。

工作階段是從使用者輸入查詢時開始，到使用者選取地點並呼叫 Place Details 或 Address Validation 時結束。在每個工作階段中，使用者可以輸入多筆查詢，最終提出一項 Place Details 或 Address Validation 要求。工作階段中每項要求使用的憑證，都必須屬於同一個 Google Cloud 控制台專案。工作階段結束後，符記就會失效。您的應用程式必須為每個工作階段產生新的符記。如果省略 session_token 參數或重複使用工作階段符記，系統會視為未提供工作階段符記，並針對工作階段收費 (每個要求分別收費)。

建議遵循下列準則：

• 在所有 Place Autocomplete 呼叫中使用工作階段符記。
• 為每個工作階段產生新的符記。建議使用第 4 版 UUID。
• 請確保工作階段內所有 Place Autocomplete、Place Details 和 Address Validation 要求使用的憑證，都屬於同一個 Cloud 控制台專案。
• 請務必針對每個新的工作階段傳遞不重複的工作階段符記。如果多個工作階段使用同一個符記，則每個要求會分別計費。

string

ID。代表這張地點相片的參照，可用於再次查詢這張地點相片 (也稱為 API「資源」名稱：places/{place_id}/photos/{photo})。

int32

最大可用寬度 (以像素為單位)。

int32

以像素為單位的最大可用高度。

AuthorAttribution

這張相片的作者。

string

使用者可透過這個連結檢舉相片問題。

string

在 Google 地圖上顯示相片的連結。

string

相片媒體的資源名稱，格式為 places/{place_id}/photos/{photo_reference}/media。

string

可用於算繪相片的短期 URI。

string

這個地點的資源名稱，格式為 places/{place_id}。可用於查詢地點。

string

地點的專屬 ID。

LocalizedText

地點的本地化名稱，適合做為簡短的說明。例如「Google Sydney」、「Starbucks」、「Pyrmont」等。

string

這項結果的一組類型標記。例如「政治」和「所在地」。如需可能值的完整清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types 的表 A 和表 B。

string

指定結果的主要類型。類型必須是 Places API 支援的類型。例如「餐廳」、「咖啡廳」、「機場」等。一個地點只能有一個主要類型。如需可能值的完整清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表 A 和表 B。如果地點的主要類型不受支援，可能就不會顯示主要類型。如果存在主要類型，則一律為 types 欄位中的其中一種。

LocalizedText

主要類型的顯示名稱，如適用，會根據要求語言進行本地化。如需可能值的完整清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表 A 和表 B。如果地點的主要類型不受支援，系統可能會遺漏主要類型。

string

使用者可解讀的地點電話號碼 (國家/地區格式)。

string

地點的電話號碼 (國際格式，使用者可解讀)。

string

這個地點的完整地址，方便使用者閱讀。

string

這個地點的簡短地址，方便使用者閱讀。

PostalAddress

郵寄地址格式的地址。

AddressComponent

每個地區層級的重複元件。請注意 address_components[] 陣列的下列事項：- 地址元件陣列包含的元件可能比 formatted_address 更多。- 除了 formatted_address 中所含的政治實體以外，這個陣列不一定會納入內含地址的所有政治實體。如要擷取包含特定地址的所有政治實體，建議您使用反向地理編碼，將地址的經緯度做為參數傳遞至要求。- 兩次要求之間的回應格式不一定相同。特別是，address_components 的數量會因要求的地址而異，對於同一個地址，數量也可能會隨時間改變。元件在陣列中的位置可能會變更。元件類型也可能會變更。後續回應中可能會缺少特定元件。

PlusCode

地點位置的 Plus Code (經緯度)。

LatLng

這個地點的位置。

Viewport

適合在地圖上顯示地點的可視區域，地圖大小為平均尺寸。這個可視範圍不應做為商家的實體邊界或服務範圍。

double

根據使用者對這個地點的評論，評分介於 1.0 和 5.0。

string

提供這個地點相關資訊的網址。

string

這個地點的官方網站，例如商家的首頁。請注意，如果是連鎖店 (例如 IKEA 商店)，這通常會是個別商店的網站，而非整個連鎖店的網站。

Review

這個地點的評論清單，依關聯性排序。最多可傳回 5 則評論。

OpeningHours

一般營業時間。請注意，如果地點全年無休 (24 小時)，系統就不會設定 close 欄位。如果用戶端要表示「全年無休 (24 小時)」，可以將 open 時間中 day 的值設為 0、hour 的值設為 0，且 minute 的值設為 0。

TimeZone

IANA 時區資料庫時區。例如「America/New_York」。

Photo

這個地點的相片相關資訊 (包括參照)。最多可傳回 10 張相片。

string

adr 微格式的地址：http://microformats.org/wiki/adr。

BusinessStatus

地點的商家狀態。

PriceLevel

地點的價格等級。

Attribution

必須與這項結果一起顯示的資料供應商。

string

圖示遮罩的截斷網址。使用者可在結尾附加類型後置字元 (例如「.svg」或「.png」)，存取不同類型的圖示。

string

icon_mask 的背景顏色，格式為十六進位顏色代碼，例如 #909CE1。

OpeningHours

未來七天 (包括今天) 的營業時間。時間範圍從要求當天的午夜開始，到六天後的晚上 11:59 結束。這個欄位包含所有營業時間的 special_days 子欄位，適用於營業時間與平常不同的日期。

OpeningHours

包含未來七天的項目陣列，包括商家次要營業時間的相關資訊。次要營業時間與商家的主要營業時間不同。舉例來說，餐廳可以將得來速或外送時段設為次要營業時間。這個欄位會根據地點類型，從預先定義的營業時間類型清單 (例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT) 填入類型子欄位。這個欄位包含所有營業時間的 special_days 子欄位，適用於營業時間與平常不同的日期。

OpeningHours

內含商家一般次要營業時間的資訊項目陣列。次要營業時間與商家的主要營業時間不同。舉例來說，餐廳可以將得來速或外送時段設為次要營業時間。這個欄位會根據地點類型，從預先定義的營業時間類型清單 (例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT) 中填入類型子欄位。

LocalizedText

含有地點摘要。摘要包含文字總覽，以及這些語言的語言代碼 (如適用)。摘要文字必須照實呈現，不得修改或變更。

PaymentOptions

商家接受的付款方式。如果沒有付款方式資料，付款方式欄位會取消設定。

ParkingOptions

地點提供的停車選項。

SubDestination

與地點相關的子目的地清單。

FuelOptions

加油站的最新燃料選項資訊。這項資訊會定期更新。

EVChargeOptions

電動車充電選項資訊。

GenerativeSummary

AI 生成的地點摘要。

ContainingPlace

目前地點所在的地區清單。

AddressDescriptor

地點的地址描述符。地址描述元包含額外資訊，可協助使用地標和區域描述位置。如要查看地址描述元的區域涵蓋範圍，請參閱 https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage。

GoogleMapsLinks

可觸發不同 Google 地圖動作的連結。

PriceRange

與地點相關聯的價格範圍。

ReviewSummary

使用使用者評論，以 AI 生成地點摘要。

EvChargeAmenitySummary

電動車充電站附近的設施摘要。

NeighborhoodSummary

地點附近的搜尋點摘要。

ConsumerAlert

如果我們在商家評論偵測到可疑活動，或是商家違反 Google 政策，就會在該地點顯示消費者警示訊息。

string

如果這個地點已永久停業並搬遷至新地點，這個欄位會包含新地點的資源名稱，格式為 places/{place_id}。如果這個地點多次搬遷，此欄位會顯示第一次搬遷的地點。如果商家未搬遷，這個欄位就不會填入資料。

string

如果這個地點已永久停業並搬遷到新地點，這個欄位會包含新地點的 ID。如果這個地點多次搬遷，這個欄位會顯示首次搬遷的地點。如果商家未搬遷，這個欄位就不會填入資料。

int32

這個地點的時區目前與世界標準時間的時差 (以分鐘為單位)。以分鐘為單位表示，支援以小時為單位 (例如 X 小時 15 分鐘) 的時區。

int32

這個地點的評論總數 (無論是否包含文字)。

bool

指出商家是否支援外帶。

bool

指定商家是否支援外送。

bool

指定商家是否提供室內或室外雅座。

bool

指定商家是否支援路邊取餐。

bool

指出地點是否支援訂位。

bool

指定該場所是否供應早餐。

bool

指定商家是否供應午餐。

bool

指定該場所是否供應晚餐。

bool

指定地點是否供應啤酒。

bool

指定地點是否供應葡萄酒。

bool

指定地點是否供應早午餐。

bool

指定地點是否供應素食餐點。

bool

提供戶外座位。

bool

提供現場音樂表演。

bool

提供兒童菜單。

bool

供應雞尾酒。

bool

提供甜點。

bool

供應咖啡。

bool

適合兒童。

bool

可帶狗入內。

bool

地點有洗手間。

bool

地點可容納團體。

bool

適合觀看運動賽事。

AccessibilityOptions

地點提供的無障礙選項相關資訊。

bool

指出地點是否為純服務範圍商家。純區域服務商家是指提供到府服務或直接送貨給顧客的商家，不在商家地址服務顧客。例如清潔或水電服務。這些商家可能沒有實體地址或 Google 地圖上的位置。

bool

地點提供無障礙停車位。

bool

地點設有無障礙入口。

bool

地點提供無障礙洗手間。

bool

場地提供無障礙座位。

string

地址元件的完整文字說明或名稱。舉例來說，澳洲地址元件的 long_name 可能為「澳洲」。

string

地址元件的縮寫文字名稱 (如有)。舉例來說，澳洲地址元件的 short_name 可能為「AU」。

string

這個陣列表示地址元件的類型。

string

以 CLDR 標記表示的語言，用於設定這個元件的格式。

string

地點資料供應商的名稱。

string

地點資料供應商的 URI。

string

消費者快訊訊息總覽。

Details

消費者快訊訊息的詳細資料。

string

消費者警示訊息的語言代碼。這是 BCP 47 語言代碼。

string

與說明一起顯示的標題。

string

消費者快訊訊息的說明。

Link

與說明一起顯示的連結，可提供更多資訊。

string

連結顯示的標題。

string

連結的 URI。

string

這個地點所在的資源名稱。

string

這個地點所在位置的地點 ID。

ContentBlock

可用的設施總覽。我們保證會提供這項服務。

ContentBlock

附近咖啡店的摘要。

ContentBlock

附近餐廳的摘要。

ContentBlock

附近商店的摘要。

string

使用者可透過這個連結回報摘要問題。

LocalizedText

「使用 Gemini 摘要」AI 揭露訊息 (以及本地化版本)。如果有的話，這項資訊會以要求中指定的語言顯示。

LocalizedText

地點總覽。

string

使用者可透過這個連結檢舉總覽摘要的問題。

LocalizedText

「使用 Gemini 摘要」AI 揭露訊息 (以及本地化版本)。如果有的話，這項資訊會以要求中指定的語言顯示。

string

顯示前往該地點路線的連結。這個連結只會填入目的地位置，並使用預設的交通方式 DRIVE。

string

顯示這個地點的連結。

string

在 Google 地圖上為這個地點撰寫評論的連結。

string

連結：在 Google 地圖上顯示這個地點的評論。

string

在 Google 地圖上顯示這個地點的相片。

ContentBlock

社區的總覽摘要。

ContentBlock

社區的詳細說明。

string

使用者可透過這個連結回報摘要問題。

LocalizedText

「使用 Gemini 摘要」AI 揭露訊息 (以及本地化版本)。如果有的話，這項資訊會以要求中指定的語言顯示。

Period

這個地點在一週內的營業時段。系統會依時間先後順序顯示各個時段，並以地點的當地時區為準。如果值為空白 (但並非不存在)，表示地點從未營業，例如因整修而暫時關閉。

periods 的起始日「並非」固定，不應假設為星期日。API 會根據多種因素決定開始日期，舉例來說，如果商家全年無休，第一個週期可能會從提出要求的當天開始。其他商家則可能是每週的第一個營業日。

注意：periods 陣列的順序與 weekday_descriptions 陣列的順序無關。請勿假設兩者會在同一天開始。

string

描述這個地點營業時間的本地化字串，一週內每天各有一個字串。

注意：星期幾的順序和一週的開始日期取決於語言和區域。periods 陣列的順序與 weekday_descriptions 陣列的順序無關。請勿假設兩者會在同一天開始。

如果營業時間不明或無法轉換為本地化文字，這個欄位會空白。例如：「Sun: 18:00–06:00」(週日：18:00 至 06:00)

SecondaryHoursType

用於識別次要營業時間類型的類型字串。

SpecialDay

特殊日期的結構化資訊，這些日期位於傳回營業時間涵蓋的期間內。特殊日子是指可能會影響地點營業時間的日子，例如聖誕節。如有特殊營業時間，請為 current_opening_hours 和 current_secondary_opening_hours 設定。

Timestamp

下次營業時間開始的日期，最遠可設為 7 天後。只有在放送要求時，營業時間不在有效期間內，系統才會填入這個欄位。

Timestamp

下次目前營業時間週期結束的時間最多為 7 天後。只有在放送請求時，營業時間時段處於啟用狀態，才會填入這個欄位。

bool

營業時間目前是否有效。如果是正常營業時間和目前營業時間，這個欄位表示地點是否營業中。如果是次要營業時間和目前的次要營業時間，這個欄位表示該地點的次要營業時間是否有效。

Point

地點開始營業的時間。

Point

商家開始歇業的時間。

Date

地點所在時區的日期。

bool

這個端點是否遭到截斷。如果實際時數超出我們願意回報的時數範圍，系統就會截斷時數，將時數截斷至這些界線。這可確保系統最多會傳回自要求當天午夜起算的 24 * 7 小時。

int32

星期幾，以 0 到 6 之間的整數表示。0 代表星期日，1 代表星期一，以此類推。

int32

以 24 小時制表示的小時。範圍為 0 到 23。

int32

一分鐘。範圍為 0 到 59。

Date

這個特別日期的日期。

bool

地點提供免費停車位。

bool

提供付費停車位。

bool

提供免費路邊停車位。

bool

提供付費路邊停車位。

bool

提供代客泊車服務。

bool

提供免費室內停車位。

bool

提供付費室內停車場。

bool

商家接受信用卡付款。

bool

商家接受簽帳金融卡付款。

bool

商家只接受現金付款。即使有這項屬性，商家仍可能接受其他付款方式。

bool

商家接受 NFC 付款。

string

地點的全球 (完整) 代碼，例如「9FWM33GV+HQ」，代表 1/8000 度 x 1/8000 度的區域 (約 14 公尺 x 14 公尺)。

string

地點的複合代碼，例如「33GV+HQ, Ramberg, Norway」，包含全球代碼的後置字串，並以參照實體的格式化名稱取代前置字串。

LocalizedText

使用者評論摘要。

string

使用者可透過這個連結回報摘要問題。

LocalizedText

「使用 Gemini 摘要」AI 揭露訊息 (以及本地化版本)。如果有的話，這項資訊會以要求中指定的語言顯示。

string

連結：在 Google 地圖上顯示這個地點的評論。

string

子目的地資源名稱。

string

子目的地的地點 ID。

string

編碼後的折線，Routes API 預設會傳回這項資訊。請參閱編碼器和解碼器工具。

Money

價格範圍的下限 (含)。價格應等於或高於這個金額。

Money

價格範圍的上限 (不含)。價格應低於這個金額。

string

代表這則地點評論的參照，可用於再次查詢這則地點評論 (也稱為 API「資源」名稱：places/{place_id}/reviews/{review})。

string

格式化近期的時間字串，以適合語言和國家/地區的形式，表示相對於目前時間的評論時間。

LocalizedText

評論的本地化文字。

LocalizedText

評論原文。

double

介於 1.0 到 5.0 之間的數字，也稱為星級。

AuthorAttribution

這則評論的作者。

Timestamp

評論的時間戳記。

string

使用者可透過這個連結檢舉評論問題。

string

可顯示 Google 地圖評論的連結。

Date

作者造訪該地點的日期。這項資訊會截斷至造訪的年份和月份。

bool

(選用步驟) 如果設為 true，系統會盡量避開收費道路，優先選擇不含收費道路的路線。僅適用於 DRIVE 和 TWO_WHEELER TravelMode。

bool

(選用步驟) 如果設為 true，系統會盡量避開高速公路，優先選擇不含高速公路的路線。僅適用於 DRIVE 和 TWO_WHEELER TravelMode。

bool

(選用步驟) 如果設為 true，系統會盡量避開渡輪，優先選擇不含渡輪的路線。僅適用於 DRIVE 和 TWO_WHEELER TravelMode。

bool

(選用步驟) 如果設為 true，系統會盡量避開室內導航，優先選擇不含室內導航的路線。僅適用於 WALK TravelMode。

LatLng

(選用步驟) 明確的轉送起點，會覆寫折線中定義的起點。根據預設，系統會使用折線原點。

TravelMode

(選用步驟) 交通方式。

RouteModifiers

(選用步驟) 路徑修飾符。

RoutingPreference

(選用步驟) 指定如何計算路徑摘要。伺服器會嘗試使用所選的轉送偏好設定來計算路徑。車流量監測路線偏好設定僅適用於 DRIVE 或 TWO_WHEELER travelMode。

Leg

行程路段。

從一組起點計算交通時間和距離時，legs 會包含單一路段，其中含有從起點到目的地的時間和距離。搜尋沿途地點時，legs 包含兩段路線：一段是從出發地到該地點，另一段是從該地點到目的地。

string

這個連結會使用指定路線摘要中的途經點，在 Google 地圖上顯示路線。這個連結產生的路線不一定與產生路線摘要的路線相同。連結會使用要求中提供的資訊 (包括 routingParameters 和 searchAlongRouteParameters 欄位，視情況而定)，產生路線連結。

Duration

完成這段行程所需的時間。

int32

這段行程的距離。

string

如果地點詳細資料有提供偏好語言版本，系統就會顯示該版本。如果語言代碼未指定或無法辨識，系統可能會傳回任何語言的商家詳細資料，如果存在英文詳細資料，則會優先傳回。

目前支援的語言清單：https://developers.google.com/maps/faq#languagesupport。

string

要求來源位置的 Unicode 國家/地區代碼 (CLDR)。這個參數用於顯示地點詳細資料，例如特定區域的地點名稱 (如有)。視適用法律而定，這個參數可能會影響結果。

詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

請注意，系統目前不支援 3 位數的區域代碼。

string

https://developers.google.com/maps/documentation/places/web-service/place-types 中包含的地點類型 (例如「restaurant」或「gas_station」)。

最多可指定 50 種表 A 類型。

如有任何衝突類型 (即類型同時出現在 included_types 和 excluded_types 中)，系統會傳回 INVALID_ARGUMENT 錯誤。

如果指定地點類型時設有多項限制，系統只會傳回符合所有限制的地點。舉例來說，如果我們有 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}，傳回的地點會提供「餐廳」相關服務，但主要業務並非「餐廳」。

string

排除的地點類型 (例如「restaurant」或「gas_station」)，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types。

最多可指定 50 種表 A 類型。

如果用戶同時提供 included_types (例如餐廳) 和 excluded_types (例如咖啡廳)，則回應應包含餐廳，但不應包含咖啡廳。回應會包含至少符合一個 included_types，且不符合任何 excluded_types 的地點。

如有任何衝突類型 (即類型同時出現在 included_types 和 excluded_types 中)，系統會傳回 INVALID_ARGUMENT 錯誤。

如果指定地點類型時設有多項限制，系統只會傳回符合所有限制的地點。舉例來說，如果我們有 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}，傳回的地點會提供「餐廳」相關服務，但主要業務並非「餐廳」。

string

內含主要地點類型 (例如「restaurant」或「gas_station」)，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types。一個地點只能與支援類型表中的單一主要類型建立關聯。

最多可指定 50 種表 A 類型。

如有任何衝突的主要類型 (即類型同時出現在 included_primary_types 和 excluded_primary_types 中)，系統會傳回 INVALID_ARGUMENT 錯誤。

如果指定地點類型時設有多項限制，系統只會傳回符合所有限制的地點。舉例來說，如果我們有 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}，傳回的地點會提供「餐廳」相關服務，但主要業務並非「餐廳」。

string

從 https://developers.google.com/maps/documentation/places/web-service/place-types 排除主要地點類型 (例如「restaurant」或「gas_station」)。

最多可指定 50 種表 A 類型。

如有任何衝突的主要類型 (即類型同時出現在 included_primary_types 和 excluded_primary_types 中)，系統會傳回 INVALID_ARGUMENT 錯誤。

如果指定地點類型時設有多項限制，系統只會傳回符合所有限制的地點。舉例來說，如果我們有 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}，傳回的地點會提供「餐廳」相關服務，但主要業務並非「餐廳」。

int32

要傳回的結果數上限。這個值必須介於 1 和 20 之間 (預設值)，如果未設定這個數字，系統會改用上限。如果數字設為負數或超過上限，系統會傳回 INVALID_ARGUMENT 錯誤。

LocationRestriction

必要欄位。要搜尋的區域。

RankPreference

回覆中結果的排序方式。

RoutingParameters

(選用步驟) 影響搜尋結果路徑的參數。

Circle

以中心點和半徑定義的圓形。

Place

符合使用者需求的地點清單，例如地點類型、地點數量和特定地點限制。

RoutingSummary

路徑摘要清單，每個項目都會與 places 欄位中相同索引的對應地點建立關聯。如果其中一個地點沒有路徑摘要，該地點的摘要就會是空白項目。如果系統要求，這份清單的項目數量應與地點清單相同。

string

必要欄位。文字搜尋的文字查詢。

string

如果地點詳細資料有提供偏好語言版本，系統就會顯示該版本。如果語言代碼未指定或無法辨識，系統可能會傳回任何語言的商家詳細資料，如果存在英文詳細資料，則會優先傳回。

目前支援的語言清單：https://developers.google.com/maps/faq#languagesupport。

string

要求來源位置的 Unicode 國家/地區代碼 (CLDR)。這個參數用於顯示地點詳細資料，例如特定區域的地點名稱 (如有)。視適用法律而定，這個參數可能會影響結果。

詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

請注意，系統目前不支援 3 位數的區域代碼。

RankPreference

回覆中結果的排序方式。

string

要求的地點類型。支援的類型完整清單：https://developers.google.com/maps/documentation/places/web-service/place-types。僅支援一種納入的類型。

bool

用於將搜尋範圍限制在目前營業中的地點。預設值為 false。

double

篩除平均使用者評分嚴格低於此限制的結果。有效值必須是介於 0 到 5 (含) 之間的浮點數，且間隔為 0.5，也就是 [0, 0.5, 1.0, ... , 5.0] (含)。輸入的評分會無條件進位至最接近的 0.5。舉例來說，如果評分為 0.6，系統就會排除所有評分低於 1.0 的結果。

int32

已淘汰：請改用 page_size。

每頁可傳回的結果數上限。如果可用結果數量大於 max_result_count，系統會傳回 next_page_token，可將其傳遞至 page_token，在後續要求中取得下一頁結果。如果提供 0 或未提供任何值，系統會使用預設值 20。最大值為 20；超過 20 的值會強制設為 20。負值會傳回 INVALID_ARGUMENT 錯誤。

如果同時指定 max_result_count 和 page_size，系統會忽略 max_result_count。

int32

(選用步驟) 每頁可傳回的結果數上限。如果可用結果數量大於 page_size，系統會傳回 next_page_token，可將其傳遞至 page_token，在後續要求中取得下一頁結果。如果提供 0 或未提供任何值，系統會使用預設值 20。最大值為 20；超過 20 的值會設為 20。負值會傳回 INVALID_ARGUMENT 錯誤。

如果同時指定 max_result_count 和 page_size，系統會忽略 max_result_count。

string

(選用步驟) 屬於接收自前一個 TextSearch 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 TextSearch 的所有參數 (page_token、page_size 和 max_result_count 除外) 須與提供網頁權杖的初始呼叫相符。否則會傳回 INVALID_ARGUMENT 錯誤。

PriceLevel

用於將搜尋範圍限制在標示為特定價位的地點。使用者可以選擇任何價位組合。預設為選取所有價格等級。

bool

用於為 included_type 設定嚴格的類型篩選條件。如果設為 true，系統只會傳回相同類型的結果。預設值為 false。

LocationBias

要搜尋的區域。這個位置會做為偏差值，也就是說，系統可能會傳回指定位置附近的結果。無法與 location_restriction 一起設定。

LocationRestriction

要搜尋的區域。這個位置會做為限制，也就是說，系統不會傳回指定位置以外的結果。無法與 location_bias 一併設定。

EVOptions

(選用步驟) 設定地點搜尋要求的電動車可搜尋選項。

RoutingParameters

(選用步驟) 將使用者導向結果的其他參數。

SearchAlongRouteParameters

(選用步驟) 沿路線搜尋時使用的額外參數 Proto。

bool

(選用步驟) 如果欄位設為 true，請加入純服務範圍商家。純區域服務商家是指提供到府服務或直接送貨給顧客的商家，不在商家地址服務顧客。例如清潔或水電服務。這些商家在 Google 地圖上沒有實體地址或位置。對於這類商家，Places 不會傳回 location、plus_code 和其他地點相關欄位。

double

(選用步驟) 以千瓦為單位的最低充電速率。系統會篩除充電速率低於指定速率的地點。

EVConnectorType

(選用步驟) 偏好的電動車充電插頭類型清單。系統會篩除不支援任何列出連接器類型的位置。

Viewport

由東北角和西南角定義的矩形方塊。rectangle.high() 必須是矩形檢視區塊的東北點。rectangle.low() 必須是矩形檢視區塊的西南點。rectangle.low().latitude() 不得大於 rectangle.high().latitude()。這會導致緯度範圍空白。矩形檢視區塊的寬度不得超過 180 度。

Circle

以中心點和半徑定義的圓形。

Viewport

由東北角和西南角定義的矩形方塊。rectangle.high() 必須是矩形檢視區塊的東北點。rectangle.low() 必須是矩形檢視區塊的西南點。rectangle.low().latitude() 不得大於 rectangle.high().latitude()。這會導致緯度範圍空白。矩形檢視區塊的寬度不得超過 180 度。

Polyline

必要欄位。路線折線。

Place

符合使用者文字搜尋條件的地點清單。

RoutingSummary

路徑摘要清單，每個項目都會與 places 欄位中相同索引的對應地點建立關聯。如果其中一個地點沒有路徑摘要，該地點的摘要就會是空白項目。如果要求提供地點清單，這份清單就會包含相同數量的項目。

ContextualContent

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

內容清單，每個項目都與地點欄位中相同索引的對應地點相關聯。建議提供與要求中 text_query 相關的內容。如果其中一個地點沒有內容相關資訊，系統會傳回非內容相關資訊。只有在該地點沒有內容時，才會顯示空白畫面。如果要求提供地點清單，這份清單就會包含相同數量的項目。

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略或留空這個欄位，就不會有後續頁面。

string

使用者可透過連結，在 Google 地圖上使用要求中指定的相同文字查詢進行搜尋。