Current Place

プラットフォームを選択: Android iOS

Places SDK for iOS を使用すると、現在デバイスがある場所を特定できます。つまり、デバイスで現在報告されている場所です。場所の例としては、地域のお店やサービス、スポット、地理的位置などがあります。

  1. 位置情報の利用許可をリクエストする
  2. 使用量上限
  3. 現在地を取得する
  4. アプリでアトリビューションを表示する

位置情報の利用許可をリクエストする

アプリで GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: を使用している場合は、位置情報サービスを使用するための権限をリクエストする必要があります。NSLocationWhenInUseUsageDescription ファイルを Info.plist ファイルに追加して、位置情報サービスを必要とする理由をユーザーに伝える文字列を定義します。例:

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

確認ダイアログをトリガーせずに、アプリがバックグラウンドで実行されているときに findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: を呼び出す場合は、電話をかける前に次の手順を行います。

  1. NSLocationAlwaysUsageDescription ファイルを Info.plist ファイルに追加します。
  2. メソッドを呼び出す前に、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%、場所 A が 35% である可能性を表すには、可能性配列に、可能性が 0.55 の場所 A と、可能性が 0.35 の場所 B という 2 つのメンバーがあります。

アプリ内でアトリビューションを表示する

アプリに GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: から取得した情報を表示する場合は、アトリビューションも表示する必要があります。詳しくは、アトリビューションをご覧ください。