目前位置

選取平台: Android iOS

您可以使用 Places SDK for iOS,找出裝置目前的所在位置。也就是裝置目前回報的位置。地點包括當地商家、搜尋點和地理位置。

  1. 要求位置授權
  2. 用量限制
  3. 取得目前位置
  4. 在應用程式中顯示歸因

要求位置授權

如果您的應用程式使用 GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:,應用程式必須要求權限才能使用定位服務。在 Info.plist 檔案中加入 NSLocationWhenInUseUsageDescription 鍵,定義您需要定位服務原因的字串。例如:

<key>NSLocationWhenInUseUsageDescription</key>
<string>Show your location on the map</string>

如要在應用程式在背景執行時呼叫 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:,而不觸發確認對話方塊,請在呼叫前按照下列步驟操作:

  1. Info.plist 檔案中新增 NSLocationAlwaysUsageDescription 鍵。
  2. 請先在 CLLocationManager 的任何例項上呼叫 requestAlwaysAuthorization,然後再呼叫此方法。

請按照下列步驟向 CLLocationManager 要求授權:

Swift

    locationManager.requestAlwaysAuthorization()
    

Objective-C

    [self.locationManager requestAlwaysAuthorization];
    

正在取得目前位置

如要尋找裝置目前所在的當地商家或其他地點,請呼叫 GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:。請加入下列參數:

  • 一或多個 GMSPlaceField,用於指定要傳回的資料類型。如果省略此參數,系統會傳回所有可能的欄位,並據此向您收費。這僅適用於 Place Details 要求。
  • 處理結果的回呼方法。

欄位會與 Place Search 結果相對應,並分為三種計費類別:「Basic」、「Contact」和「Atmosphere」。「Basic」欄位以基本費率計費,不會產生額外費用。「Contact」和「Atmosphere」欄位會以較高的費率計費。如要進一步瞭解地點資料要求的計費方式,請參閱「用量與計費」一文。

API 會叫用指定的回呼方法,傳回 GMSPlaceLikelihood 物件的陣列。

每個 GMSPlaceLikelihood 物件都代表一個地點。每個地點的結果都包含正確資訊,可指出該地點是否位於正確位置。值越大,代表地點與地點比對成功的機率越高。如果沒有與裝置位置相對應的已知位置,緩衝區可能會空白。

下列程式碼範例會擷取裝置最有可能的位置清單,並記錄每個地點的名稱和可能性。

Swift

// Specify the place data types to return.
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
                                          UInt(GMSPlaceField.placeID.rawValue))!
placesClient?.findPlaceLikelihoodsFromCurrentLocation(withPlaceFields: fields, callback: {
  (placeLikelihoodList: Array<GMSPlaceLikelihood>?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }

  if let placeLikelihoodList = placeLikelihoodList {
    for likelihood in placeLikelihoodList {
      let place = likelihood.place
      print("Current Place name \(String(describing: place.name)) at likelihood \(likelihood.likelihood)")
      print("Current PlaceID \(String(describing: place.placeID))")
    }
  }
})

Objective-C

// Specify the place data types to return.
GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);
[_placesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:fields callback:^(NSArray<GMSPlaceLikelihood *> * _Nullable likelihoods, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (likelihoods != nil) {
    for (GMSPlaceLikelihood *likelihood in likelihoods) {
      GMSPlace *place = likelihood.place;
      NSLog(@"Current place name: %@", place.name);
      NSLog(@"Place ID: %@", place.placeID);
    }
  }
}];

可能值相關注意事項:

  • 可能性是指針對單一要求,在傳回的地點清單中為地點最相符的結果,提供相對機率。您無法比較不同要求的可能性。
  • 可能性值介於 0 和 1.0。
  • GMSPlaceLikelihood 物件所傳回陣列的可能性總和一律小於或等於 1.0。請注意,總和不一定是 1.0。

舉例來說,假設地點 A 代表正確地點 A 的機率為 55%,以及地點 B 的可能性為 35%,可能的陣列會有兩個成員:地點 A 的可能性為 0.55,地點 B 的可能性是 0.35。

在應用程式中顯示作者資訊

當應用程式顯示從 GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 取得的資訊時,應用程式也必須顯示作者資訊。進一步瞭解作者資訊