PlacesService class
google.maps.places.PlacesService
class
包含與搜尋地點及擷取地點詳細資料相關的方法。
撥打 const {PlacesService} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
PlacesService |
PlacesService(attrContainer)參數：
建立 PlacesService 的新例項，在指定容器中算繪出處。 |
方法 | |
|---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback)參數：
傳回值：無
根據電話號碼擷取地點清單。在多數情況下，結果清單中只會有一項，但如果要求不明確，可能會傳回多項結果。傳遞至回呼的 PlaceResult 是完整 PlaceResult 的子集。應用程式可以呼叫 PlacesService.getDetails 並傳遞所需地點的 PlaceResult.place_id，取得每個地點的詳細 PlaceResult。 |
findPlaceFromQuery |
findPlaceFromQuery(request, callback)參數：
傳回值：無
根據查詢字串擷取地點清單。在多數情況下，結果清單中只會有一項，但如果要求不明確，可能會傳回多項結果。傳遞至回呼的 PlaceResult 是完整 PlaceResult 的子集。應用程式可以呼叫 PlacesService.getDetails 並傳遞所需地點的 PlaceResult.place_id，取得每個地點的詳細 PlaceResult。 |
getDetails |
getDetails(request, callback)參數：
傳回值：無
擷取由指定 placeId 識別的地點詳細資料。 |
nearbySearch |
nearbySearch(request, callback)參數：
傳回值：無
根據關鍵字或類型，擷取特定地點附近的場所清單。您必須一律指定位置，方法是傳遞 LatLngBounds，或 location 和 radius 參數。傳遞至回呼的 PlaceResult 是完整 PlaceResult 的子集。應用程式可以傳送 Place Details 要求，並傳遞所需地點的 PlaceResult.place_id，取得每個地點的詳細 PlaceResult。PlaceSearchPagination 物件可用來擷取其他結果頁面 (如果這是最後一頁結果，或只有一頁結果，則為空值)。 |
textSearch |
textSearch(request, callback)參數：
傳回值：無
根據查詢字串 (例如「紐約市的披薩」或「渥太華附近的鞋店」) 擷取地點清單。位置參數為選用參數。指定位置後，系統只會優先顯示附近的結果，不會限制在該區域內的地點。如要使用任意字串搜尋地點，且不想將搜尋結果限制在特定地點，請使用 textSearch。PlaceSearchPagination 物件可用來擷取其他結果頁面 (如果這是最後一頁結果，或只有一頁結果，則為空值)。 |
PlaceDetailsRequest 介面
google.maps.places.PlaceDetailsRequest
介面
要傳送至 PlacesService 的 Place Details 查詢。
屬性 | |
|---|---|
placeId |
類型：
string要查詢詳細資料的地點 ID。 |
fields optional |
類型：
Array<string> optional要納入詳細資料回應的欄位，這些欄位會產生費用。如未指定任何欄位，或已傳入 ['ALL']，系統會傳回所有可用的欄位並據此收費 (不適用於實際工作環境部署作業)。如需欄位清單，請參閱 PlaceResult。巢狀欄位可使用點路徑指定 (例如 "geometry.location")。 |
language optional |
類型：
string optional詳細資料應傳回的語言 ID。請參閱支援語言清單。 |
region optional |
類型：
string optional使用者所在區域的區域代碼。這可能會影響系統傳回的相片，以及其他項目。區碼接受 ccTLD (「頂層網域」) 的兩位字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同，只有少數例外。舉例來說，英國的 ccTLD 是「uk」( .co.uk)，而 ISO 3166-1 代碼是「gb」(技術上是指「大不列顛及北愛爾蘭聯合王國」實體)。 |
sessionToken optional |
類型： |