您可以使用 Places SDK for iOS,找出裝置目前的所在位置。也就是裝置目前回報的位置。地點包括當地商家、搜尋點和地理位置。
要求位置授權
如果您的應用程式使用
GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
,應用程式必須要求權限才能使用定位服務。在 Info.plist
檔案中加入 NSLocationWhenInUseUsageDescription
鍵,定義您需要定位服務原因的字串。例如:
<key>NSLocationWhenInUseUsageDescription</key> <string>Show your location on the map</string>
如要在應用程式在背景執行時呼叫
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
,而不觸發確認對話方塊,請在呼叫前按照下列步驟操作:
- 在
Info.plist
檔案中新增NSLocationAlwaysUsageDescription
鍵。 - 請先在
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:
取得的資訊時,應用程式也必須顯示作者資訊。進一步瞭解作者資訊。