Text Search (新版)

Text Search 會傳回一組地點的相關資訊 來產生這種文字說明的模型例如：「臺北披薩」、「附近的鞋店 渥太華」或「中正路 123 號」。這項服務會傳回地點清單 比對文字字串和任何已設定的位置自訂調整。

這項服務在建立語意明確的地址時特別實用 查詢 字串中的非地址元件可能與商家 讓我們看看 DNS 解析 進一步探索內部和外部位址模稜兩可的地址查詢範例；地址格式有誤 或是包含非地址元件 (例如商家名稱) 的要求。 如前兩個範例類似的要求，可能會傳回零結果，除非 位置 (例如區域、位置限製或位置自訂調整)。

透過文字搜尋取得地點清單

呼叫 GMSPlacesClient searchByTextWithRequest: 即可發出 Text Search 要求。 傳送 GMSPlaceSearchByTextRequest 物件，作用是定義要求參數以及回呼方法，類型為 GMSPlaceSearchByTextResultCallback、 處理回應。

GMSPlaceSearchByTextRequest 物件會指定 required 和 optional 參數 。必要參數包括：

• 要在 GMSPlace 物件中傳回的欄位清單，也 稱為欄位遮罩，如 GMSPlaceProperty。 如果您未在欄位清單中指定至少一個欄位，或 欄位清單，則呼叫會傳回錯誤。
• 文字查詢。

這個文字搜尋要求範例會指定回應 GMSPlace 物件 包含搜尋中的每個 GMSPlace 物件的地點名稱和地點 ID 也就是預測結果也會篩選回應，只傳回類型的地點 「餐廳」。

// 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)

// 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;
      }
    }
  }
];

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 物件都可以包含作者資訊以及作者作者資訊。 如果您在應用程式中顯示評論，則必須一併顯示作者資訊或作者。 出處。

詳情請參閱 作者資訊。