Text Search 會傳回一組地點的相關資訊 來產生這種文字說明的模型例如:「臺北披薩」、「附近的鞋店 渥太華」或「中正路 123 號」。這項服務會傳回地點清單 比對文字字串和任何已設定的位置自訂調整。
這項服務在建立語意明確的地址時特別實用 查詢 字串中的非地址元件可能與商家 讓我們看看 DNS 解析 進一步探索內部和外部位址模稜兩可的地址查詢範例;地址格式有誤 或是包含非地址元件 (例如商家名稱) 的要求。 如前兩個範例類似的要求,可能會傳回零結果,除非 位置 (例如區域、位置限製或位置自訂調整)。
「英國 10 號高街」或「美國中正路 123 號」 | 英國的多個「高街」;美國境內的多個「主街」。 除非有地點限制,否則查詢不會傳回理想的結果 設定。 |
「臺北市中餐廳」 | 多間「中國餐廳」臺北市無街道地址, 甚至是街道名稱 |
「10 High Street, Escher UK」或「美國臺北市中正區 123 號」 | 只有一個「高街」;只有一個「中正路」 美國境內 Pleasanton 的用戶。 |
「UniqueRestaurantName New York」 | 紐約地只有一間同名的建築物;無街道地址 以便區分。 |
「臺北市的披薩店」 | 這項查詢包含其位置限制和「披薩餐廳」為 定義明確的地點類型並傳回多項結果。 |
「+1 514-670-8700」 | 這項查詢包含電話號碼。它會傳回多個以下項目的結果: 與該組電話號碼相關聯的地點。 |
透過文字搜尋取得地點清單
呼叫 GMSPlacesClient
searchByTextWithRequest:
即可發出 Text Search 要求。
傳送
GMSPlaceSearchByTextRequest
。
物件,作用是定義要求參數以及回呼方法,類型為
GMSPlaceSearchByTextResultCallback
,
處理回應。
GMSPlaceSearchByTextRequest
物件會指定
required 和 optional 參數
。必要參數包括:
- 要在
GMSPlace
物件中傳回的欄位清單,也 稱為欄位遮罩,如GMSPlaceProperty
。 如果您未在欄位清單中指定至少一個欄位,或 欄位清單,則呼叫會傳回錯誤。 - 文字查詢。
這個文字搜尋要求範例會指定回應 GMSPlace
物件
包含搜尋中的每個 GMSPlace
物件的地點名稱和地點 ID
也就是預測結果也會篩選回應,只傳回類型的地點
「餐廳」。
Swift
// Create the GMSPlaceSearchByTextRequest object. let myProperties = [GMSPlaceProperty.name, GMSPlaceProperty.placeID].map {$0.rawValue} let request = GMSPlaceSearchByTextRequest(textQuery:"pizza in New York", placeProperties:myProperties) request.isOpenNow = true request.includedType = "restaurant" request.maxResultCount = 5 request.minRating = 3.5 request.rankPreference = .distance request.isStrictTypeFiltering = true request.locationBias = GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(40.7, -74.0), 200.0) // Array to hold the places in the response var placeResults: [GMSPlace] = [] let callback: GMSPlaceSearchByTextResultCallback = { [weak self] results, error in guard let self, error == nil else { if let error { print(error.localizedDescription) } return } guard let results = results as? [GMSPlace] else { return } placeResults = results } GMSPlacesClient.shared().searchByText(with: request, callback: callback)
Objective-C
// Create the GMSPlaceSearchByTextRequest object. GMSPlaceSearchByTextRequest *request = [[GMSPlaceSearchByTextRequest alloc] initWithTextQuery:@"pizza in New York" placeProperties:@[GMSPlacePropertyName, GMSPlacePropertyPlaceID]]; request.isOpenNow = YES; request.includedType = @"restaurant"; request.maxResultCount = 5; request.minRating = 3.5; request.rankPreference = GMSPlaceSearchByTextRankPreferenceDistance; request.isStrictTypeFiltering = YES; request.priceLevels = @[ @(kGMSPlacesPriceLevelFree), @(kGMSPlacesPriceLevelCheap) ]; request.locationBias = GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(40.7, -74.0), 200.0); // Array to hold the places in the response _placeResults = [NSArray array]; // Create the GMSPlaceSearchByTextRequest object. [_placesClient searchByTextWithRequest:request callback:^(NSArray<GMSPlace *> *_Nullable placeResults, NSError * _Nullable error) { if (error != nil) { NSLog(@"An error occurred %@", [error localizedDescription]); return; } else { if (placeResults.count > 0) { // Get list of places. _placeResults = placeResults; } } } ];
GooglePlacesSwift
let restriction = RectangularLocationRestriction( northEast: CLLocationCoordinate2D(latitude: 20, longitude: 30), southWest: CLLocationCoordinate2D(latitude: 40, longitude: 50) ) let searchByTextRequest = SearchByTextRequest( textQuery: "pizza in New York", placeProperties: [ .name, .placeID ], locationRestriction: restriction, includedType: .restaurant, maxResultCount: 5, minRating: 3.5, priceLevels: [ .moderate, .inexpensive ], isStrictTypeFiltering: true ) switch await placesClient.searchByText(with: searchByTextRequest) { case .success(let places): // Handle places case .failure(let placesError): // Handle error }
Text Search 回應
Text Search API 會在
形式
GMSPlace
敬上
物件,每個相符地點都有一個 GMSPlace
物件。
除了資料欄位之外,GMSPlace
回應包含下列成員函式:
-
isOpen
會計算地點在指定時間是否營業。 isOpenAtDate
敬上 計算地點在指定日期是否營業。
必要參數
使用 GMSPlaceSearchByTextRequest
物件指定所需的必要物件
參數。
-
欄位清單
指定要傳回的地點資料屬性。傳送
GMSPlace
敬上 用於指定要傳回資料欄位的屬性。如果您省略欄位 遮罩,要求會傳回錯誤。欄位清單是不錯的設計做法,可確保您不要要求這些清單 不必要的資料,有助於避免不必要的處理時間,並 帳單費用。
指定下列一或多個欄位:
下列欄位會觸發 Text Search (ID Only) SKU:
GMSPlacePropertyPlaceID
,GMSPlacePropertyName
下列欄位會觸發 Text Search (基本) SKU:
GMSPlacePropertyAddressComponents
,GMSPlacePropertyBusinessStatus
,GMSPlacePropertyFormattedAddress
,GMSPlacePropertyIconBackgroundColor
,GMSPlacePropertyIconImageURL
,GMSPlacePropertyCoordinate
,GMSPlacePropertyPhotos
,GMSPlacePropertyPlusCode
,GMSPlacePropertyTypes
,GMSPlacePropertyUTCOffsetMinutes
,GMSPlacePropertyViewport
,GMSPlacePropertyWheelchairAccessibleEntrance
。下列欄位會觸發 Text Search (進階) SKU:
GMSPlacePropertyCurrentOpeningHours
,GMSPlacePropertySecondaryOpeningHours
,GMSPlacePropertyPhoneNumber
,GMSPlacePropertyPriceLevel
,GMSPlacePropertyRating
,GMSPlacePropertyOpeningHours
,GMSPlacePropertyUserRatingsTotal
,GMSPlacePropertyWebsite
下列欄位會觸發 Text Search (Preferred) SKU:
GMSPlacePropertyCurbsidePickup
,GMSPlacePropertyDelivery
,GMSPlacePropertyDineIn
,GMSPlacePropertyEditorialSummary
,GMSPlacePropertyReservable
,GMSPlacePropertyReviews
,GMSPlacePropertyServesBeer
,GMSPlacePropertyServesBreakfast
,GMSPlacePropertyServesBrunch
,GMSPlacePropertyServesDinner
,GMSPlacePropertyServesLunch
,GMSPlacePropertyServesVegetarianFood
,GMSPlacePropertyServesWine
,GMSPlacePropertyTakeout
。
-
textQuery
要搜尋的文字字串,例如「餐廳」、「中正路 123 號」 「街道」或「舊金山最佳去處」。
選用參數
使用 GMSPlaceSearchByTextRequest
物件指定選用項目
參數。
includedType
限制在結果中只顯示符合 指定類型 的地點 表 A. 您只能指定一個類型。例如:
request.includedType = "bar"
request.includedType = "pharmacy"
isOpenNow
如果
true
,請只傳回營業中的地點 寫入時。如果false
,請退回所有商家 不論是否開啟狀態 在 Google 地點介面集資料庫中,未指定營業時間的地點是指 如果您將這個參數設為false
,就會傳回 。isStrictTypeFiltering
與
includeType
參數搭配使用。設為true
,只顯示符合指定類型的地點 會傳回includeType
。 如果為 false,則回應包含不相符的地點。 指定類型。locationBias
指定要搜尋的區域。這個位置只是偏見 可以傳回指定位置附近的結果,包括 結果 指定區域外。
您可以指定
locationRestriction
或locationBias
但不能同時採用兩者您可以將locationRestriction
想成是指定 結果所在的區域,以及locationBias
為 用於指定結果必須鄰近的區域,但可以位於 這個區域請將區域指定為矩形可視區域或圓形。
圓形是由中心點和半徑 (以公尺為單位) 所定義。半徑 必須介於 0.0 至 50000.0 (含) 之間。預設半徑為 0.0。 例如:
request.locationBias = GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(40.7, -74.0), 200.0)
矩形是經緯度可視區域,以兩個 沿著低點和高點對角線。低點標示西南方 矩形的角落,高點代表東北方
我們將可視區域視為 封閉區域,表示包含其邊界。緯度界限 必須介於 -90 到 90 度 (含經度邊界) 之間 必須介於 -180 到 180 度之間 (含首尾):
- 如果
low
=high
,表示可視區域由 單一點 - 如果
low.longitude
>high.longitude
, 經度範圍會反轉 (可視區域跨越 180 度 經度線)。 - 如果
low.longitude
= -180 度,且high.longitude
= 180 度,可視區域包含所有 經度 - 如果
low.longitude
= 180 度,且high.longitude
= -180 度,經度範圍是 並將空無一物。 - 如果
low.latitude
>high.latitude
, 緯度範圍空白。
- 如果
locationRestriction
指定要搜尋的區域。不是指定區域以外的結果 。將區域指定為矩形可視區域。查看說明 /
locationBias
以瞭解定義檢視點的相關資訊。您可以指定
locationRestriction
或locationBias
但不能同時採用兩者您可以將locationRestriction
想成是指定 結果所在的區域,以及locationBias
為 用於指定結果必須鄰近的區域,但可以位於 這個區域-
maxResultCount
指定要傳回的地點結果數量上限。必須介於 1 至 20 (預設) 值,含首尾。
minRating
限制只傳回使用者平均評分大於 的結果 或等於此上限這個值必須介於 0.0 和 5.0 (含) 之間 整數值。例如:0、0.5、1.0、...、5.0 (含)。值為 會四捨五入至最接近的 0.5。舉例來說,如果值是 0.6,就會排除所有 評分低於 1.0 的結果
-
priceLevels
僅搜尋標有特定價位的地點。 預設設定是選取所有價位。
指定由一或多個值定義的陣列
PriceLevel
。例如:
request.priceLevels = [GMSPlacesPriceLevel.moderate.rawValue, GMSPlacesPriceLevel.cheap.rawValue]
rankPreference
依據類型 查詢:
- 如果是「紐約市餐廳」這類類別查詢,
.relevance
(依搜尋關聯性排名) 是預設值。 您可以將rankPreference
設為.relevance
或.distance
(依距離排名結果)。 - 如果是非類別查詢,例如「Mountain View, CA」
您未設定
rankPreference
。
- 如果是「紐約市餐廳」這類類別查詢,
regionCode
用於設定回應格式的區碼,以 也就是雙字元 CLDR 代碼值。這個參數可能會造成偏誤 相關的更多內容沒有預設值。
如果回覆地址欄位的國家/地區名稱與 區碼,則地址中略過國家/地區代碼。
大部分 CLDR 代碼與 ISO 3166-1 代碼相同 有一些值得注意的例外情況舉例來說,英國的 ccTLD 是 「uk」(.co.uk),但 ISO 3166-1 代碼卻是「gb」(技術上來說 「大不列顛暨北愛爾蘭聯合王國」)。 這個參數會根據適用法律影響結果。
在應用程式中顯示作者資訊
應用程式顯示
GMSPlacesClient
、
(例如相片和評論),應用程式也必須顯示必要的作者資訊。
例如 GMSPlacesClient
物件的 reviews
屬性
包含一個最多五個的陣列
GMSPlaceReview
敬上
如需儲存大量結構化物件
建議使用 Cloud Bigtable每個 GMSPlaceReview
物件都可以包含作者資訊以及作者作者資訊。
如果您在應用程式中顯示評論,則必須一併顯示作者資訊或作者。
出處。
詳情請參閱 作者資訊。