Places SDK for iOS を使用すると、デバイスが現在位置している場所を検出できます。つまり、デバイスで現在報告されている位置の場所です。場所の例としては、ローカル ビジネス、スポット、地理的位置などがあります。
位置情報の承認をリクエストする
GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
を使用するアプリでは、位置情報サービスを使用する権限をリクエストする必要があります。NSLocationWhenInUseUsageDescription
キーを Info.plist
ファイルに追加して、位置情報サービスが必要な理由をユーザーに知らせる文字列を定義します。例:
<key>NSLocationWhenInUseUsageDescription</key> <string>Show your location on the map</string>
アプリがバックグラウンドで動作しているときに、確認ダイアログをトリガーせずに
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
を呼び出す場合は、次のように呼び出します。
NSLocationAlwaysUsageDescription
キーをInfo.plist
ファイルに追加します。- メソッドを呼び出す前に、
CLLocationManager
の任意のインスタンスでrequestAlwaysAuthorization
を呼び出します。
次のように CLLocationManager
から承認をリクエストします。
Swift
locationManager.requestAlwaysAuthorization()
Objective-C
[self.locationManager requestAlwaysAuthorization];
現在地を取得する
デバイスの現在地があるローカル ビジネスなどの場所を検索するには、GMSPlacesClient
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
を呼び出します。次のパラメータを含めます。
- 1 つ以上の
GMSPlaceField
。返されるデータ型を指定する。このパラメータを省略すると、指定可能なフィールドがすべて返され、それに応じて料金が発生します。これは Place Details リクエストにのみ適用されます。 - 結果を処理するコールバック メソッド。
フィールドは Place Search の結果に対応しており、Basic(基本)、Contact(連絡先)、Atmosphere(雰囲気)の 3 つの請求カテゴリに分けられます。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); } } }];
Likelihood 値について:
- この可能性は、1 回のリクエストに対して返された場所のリストの中で、その場所が最適であるという相対的な確率を示します。異なるリクエストの可能性を比較することはできません。
- Likelihood の値は、0~1.0 です。
- 返された
GMSPlaceLikelihood
オブジェクトの配列内の可能性の合計は、常に 1.0 以下になります。合計が必ずしも 1.0 になるとは限りません。
たとえば、正しい場所が場所 A である可能性が 55%、場所 B である可能性が 35% であることを表す場合、可能性の配列には、可能性が 0.55 である場所 A と 0.35 の地域 B という 2 つのメンバーが含まれます。
アプリに帰属表示を表示する
GMSPlacesClient
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
から取得した情報をアプリに表示する場合は、属性も表示する必要があります。詳しくは、アトリビューションをご覧ください。