GMSPlacesClient クラス リファレンス

Google Places SDK for iOS 用の GMSPlacesClient の共有インスタンスを提供し、必要に応じて作成します。

アプリで GMSPlacesClient のメソッドを頻繁に使用する場合は、このオブジェクトを直接保持することをおすすめします。そうしないと、Google への接続が定期的に再開される可能性があります。

作成した API キーを Google Places SDK for iOS に提供します。

このキーは Google Cloud Platform コンソールを介してアプリケーションに対して生成され、アプリケーションを識別するためにアプリケーションのバンドル ID とペアリングされます。これは、GMSPlacesClient を使用する前に、アプリケーションで呼び出す必要があります（application:didFinishLaunchingWithOptions: などで）。

戻り値:

APIKey が正常に提供された場合は YES。

Google Places SDK for iOS のオープンソース ソフトウェア ライセンス情報を返します。

この情報は、アプリケーション内で利用できるようにする必要があります。

Google Places SDK for iOS のこのリリースのバージョンを返します。

をタップします。例: 「1.0.0」

Google Places SDK for iOS のこのリリースのロング バージョンを返します。

をタップします。例: 「1.0.0 (102.1)".

場所の詳細情報を取得する。

このメソッドは非ブロックです。

パラメータ:

placeID	検索するプレイス ID。
callback	ルックアップ結果とともに呼び出すコールバック。

注:

これは非推奨です。このメソッドは fetchPlaceWithRequest:callback: に置き換えられました。今後のリリースで削除される予定です。

テキストクエリから予測入力の候補を見つけます。

検索結果には、特定の地域を優先したり、特定の地域に限定したりすることもできます。このメソッドは非ブロックです。

成功すると予測入力の候補の配列とともに、指定されたコールバックが呼び出され、エラーになると NSError が呼び出されます。

パラメータ:

request	予測入力の GMSAutocompleteRequest リクエスト。
callback	候補とともに呼び出すコールバック。

場所に関連付けられた最大 10 枚の写真のメタデータを取得します。

写真は、ビジネス オーナーや Google+ ユーザーが投稿した写真など、さまざまな場所から取得されます。ほとんどの場合、これらの写真は帰属情報なしで使用することも、画像の一部として必要な帰属情報が含まれることもあります。ただし、必要な帰属情報を追加で取得する場合は、レスポンスで attributions プロパティを使用して、その帰属情報を、画像が表示される場所であればどこでもアプリケーションに表示する必要があります。最大 10 枚の写真が返されます。

多くの場合、このメソッドを複数回呼び出すと、毎回同じ写真が返されます。ただし、基になるデータが変更された可能性があるため、これは保証されません。

このメソッドはネットワーク ルックアップを実行します。

パラメータ:

placeID	写真を検索するプレイス ID。
callback	ルックアップ結果とともに呼び出すコールバック。

特定の写真の画像を最大サイズで読み込みます。

画像データは SDK によってキャッシュに保存される場合があります。リクエストされた写真がキャッシュに存在しない場合は、ネットワーク検索が実行されます。

パラメータ:

photoMetadata	UIImage を読み込む GMSPlacePhotoMetadata。
callback	読み込まれた UIImage で呼び出すコールバック。

特定の写真の画像を読み込みます。指定された最大サイズに合わせてスケーリングします。

画像は、元の画像のアスペクト比を維持しながら、指定したサイズに収まるように調整されます。このスケーリングはサーバーサイドで行われます。

スケール パラメータが 1.0 でない場合、maxSize がこの値が乗算され、返される UIImage は指定したスケールに設定されます。画面に表示する画像を読み込む場合は、このパラメータを画面スケールに設定する必要があります。

画像データは SDK によってキャッシュに保存される場合があります。リクエストされた写真がキャッシュに存在しない場合は、ネットワーク検索が実行されます。

注:

スケール係数を適用すると、maxSize のディメンションは最も近い整数に切り上げられてから使用されます。使用可能な最大サイズを超える画像がリクエストされた場合は、それより小さい画像が返されることがあります。

</ph>

パラメータ:

photoMetadata	UIImage を読み込む GMSPlacePhotoMetadata。
maxSize	画像の最大サイズ。
WAF によるメリット	画像を読み込む際のスケール。
callback	読み込まれた UIImage で呼び出すコールバック。

デバイスの現在位置がわかっている場所の推定情報を返します。

デバイスの最新の推定位置情報に基づいて、場所の可能性リストを生成します。渡されたコールバックは、成功するとこの可能性リストとともに呼び出され、エラーになると NSError が呼び出されます。

注:

この方法を使用するには、アプリの現在のデバイスの位置情報にアクセスする権限が必要です。この関数を呼び出す前に、[CLLocationManager requestWhenInUseAuthorization] または [CLLocationManager requestAlwaysAuthorization] を使用して、ユーザーの位置情報へのアクセスをリクエストしてください。このメソッドを呼び出した際、アプリに正しい承認ステータスがない場合は、コールバックが呼び出され、エラーになります。

</ph>

パラメータ:

callback

場所の可能性リストで呼び出すコールバック。

テキストクエリから予測入力候補を見つけます。

検索結果には、特定の地域を優先したり、特定の地域に限定したりすることもできます。このメソッドは非ブロックです。

成功すると予測入力候補の配列とともに、指定されたコールバックが呼び出され、エラーになると NSError が呼び出されます。

パラメータ:

クエリ	予測入力の対象となる部分的なテキスト。
フィルタ	結果に適用するフィルタ。このパラメータは nil にすることもできます。
sessionToken	リクエストを課金セッションに関連付ける GMSAutocompleteSessionToken。
callback	予測とともに呼び出すコールバック。

場所の詳細を取得します。

このメソッドは非ブロックです。

パラメータ:

placeID	検索するプレイス ID。
placeFields	リスト内のプレイス オブジェクトに対してリクエストされる個々のプレイス フィールド。
sessionToken	リクエストを課金セッションに関連付ける GMSAutocompleteSessionToken。
callback	ルックアップ結果とともに呼び出すコールバック。

注:

これは非推奨です。このメソッドは fetchPlaceWithRequest:callback: callback: に置き換えられました。今後のリリースで削除される予定です。

ユーザーの現在地に基づいて、場所の可能性を検出します。

このメソッドは非ブロックです。

指定されたコールバックは、成功した場合は可能性スコア、エラーの場合は NSError を含む場所の配列で呼び出されます。

パラメータ:

placeFields	リスト内のプレイス オブジェクトに対してリクエストされる個々のプレイス フィールド。
callback	場所の可能性に基づいて呼び出すコールバック。

場所の営業状況（指定された NSDate の GMSPlaceOpenStatus を確認するために必要なすべてのプロパティを含む）を取得します。このメソッドは非ブロックです。

パラメータ:

isOpenRequest	特定の場所の営業状況を確認するためのリクエストです。
callback	オープン ステータス レスポンスで呼び出すコールバック。

場所の営業状況を取得します。これには、現在の時刻の GMSPlaceOpenStatus を判断するために必要なすべてのフィールドが含まれます。

このメソッドは非ブロックです。

パラメータ:

placeID	検索するプレイス ID。
callback	プレイスの結果とともに呼び出すコールバック。

場所の営業状況（指定された NSDate の GMSPlaceOpenStatus を特定するために必要なすべてのフィールドを含む）を取得します。

このメソッドは非ブロックです。

パラメータ:

placeID	検索するプレイス ID。
date	営業状況を確認する NSDate。
callback	プレイスの結果とともに呼び出すコールバック。

場所の営業状況を取得します。これには、現在の時刻の GMSPlaceOpenStatus を判断するために必要なすべてのフィールドが含まれます。

GMSPlace に必要なフィールドがすべて揃っていない場合にのみ、追加のフィールドをリクエストします。それ以外の場合は、コールバックですぐに GMSPlaceOpenStatus が返されます。このメソッドは非ブロックです。

パラメータ:

場所	検索する GMSPlace。
callback	プレイスの結果とともに呼び出すコールバック。

指定された NSDate の GMSPlaceOpenStatus を特定するために必要なすべてのフィールドを含む、場所の詳細を取得します。

GMSPlace に必要なフィールドがすべて揃っていない場合にのみ、追加フィールドをリクエストします。それ以外の場合は GMSPlaceOpenStatus\ will be returned in the callback immediately. This method is non-blocking. です。

テキストと制限を使用して場所を検索します。

このメソッドは非ブロックです。

パラメータ:

textSearchRequest	GMSPlaceSearchByTextRequest: クエリに使用するテキスト リクエスト。
callback	ルックアップ結果とともに呼び出すコールバック。

リクエスト オブジェクトを使用して場所を取得します。

このメソッドは非ブロックです。

パラメータ:

fetchPlaceRequest	GMSFetchPlaceRequest: クエリに使用する場所の取得リクエスト。
callback	プレイスの結果とともに呼び出すコールバック。

写真取得リクエストを使用して写真をリクエストします。

このメソッドは非ブロックです。

パラメータ:

fetchPhotoRequest	GMSFetchPhotoRequest: 使用する写真リクエスト。
callback	NSURL の結果とともに呼び出すコールバック。

指定した場所と制限の近くの場所を検索します。

このメソッドは非ブロックです。

パラメータ:

searchNearbyRequest	GMSPlaceSearchNearbyRequest: クエリに使用する Nearby Search リクエスト。
callback	ルックアップ結果とともに呼び出すコールバック。

Place Details のルックアップを受け取るためのコールバック タイプ。

エラーが発生した場合、result は nil になり、error にはエラーに関する情報が含まれます。

パラメータ:

件の結果	返された GMSPlace。
エラー	発生したエラー（ある場合）。

場所の可能性リストを受け取るためのコールバック タイプ。

エラーが発生した場合、likelihoodList は nil になり、error にはエラーに関する情報が含まれます。

パラメータ:

likelihoodList	場所の可能性のリスト。
エラー	発生したエラー（ある場合）。

GMSPlaceLikelihood の配列を受け取るためのコールバック タイプ。

エラーが発生した場合、配列は nil になり、error にエラーに関する情報が格納されます。

予測入力の結果を受け取るためのコールバック タイプ。

results は、クエリの候補候補を表す GMSAutocompletePredictions の配列です。

パラメータ:

結果	GMSAutocompletePrediction の配列。
エラー	発生したエラー（ある場合）。

場所の写真の結果を受け取るためのコールバック タイプ。

エラーが発生した場合、photos は nil になり、error にはエラーに関する情報が含まれます。

パラメータ:

写真	GMSPlacePhotoMetadata オブジェクトを含む結果。
エラー	発生したエラー（ある場合）。

GMSPlacePhotoMetadata オブジェクトから UIImage オブジェクトを受け取るためのコールバック タイプ。

エラーが発生した場合、photo は nil になり、error にはエラーに関する情報が含まれます。

パラメータ:

写真	読み込まれた UIImage。
エラー	発生したエラー（ある場合）。

場所の営業時間のステータスを受け取るためのコールバック タイプ。

エラーが発生した場合、result は GMSPlaceOpenStatusUnknown になり、error にはエラーに関する情報が格納されます。

パラメータ:

件の結果	返された GMSPlaceOpenStatus。
エラー	発生したエラー（ある場合）。

オープン ステータス レスポンスを受信するためのコールバック タイプ。

エラーが発生した場合、レスポンスは GMSPlaceOpenStatusUnknown のステータスとなり、error にはエラーに関する情報が含まれます。

パラメータ:

レスポンス	返された GMSPlaceIsOpenResponse。
エラー	発生したエラー（ある場合）。

テキストによる検索の結果を受け取るためのコールバック タイプ。

results は、クエリに一致する個々の結果を表す GMSPlace の配列です。

パラメータ:

結果	GMSPlace の配列。
エラー	発生したエラー（ある場合）。

写真を受信するためのコールバック タイプ。

photoImage は、指定されたリクエストに一致する結果の写真を表す UIImage です。エラーが発生した場合、photoImage は nil になり、error にはエラーに関する情報が含まれます。

パラメータ:

photoImage

UIImage の結果。

予測入力結果のコールバック タイプ。

パラメータ:

結果	GMSAutocompleteSuggestion の配列。
エラー	発生したエラー（ある場合）。

付近の検索結果を受け取るためのコールバック タイプ。

パラメータ:

場所	GMSPlace の配列
エラー	発生したエラー（ある場合）。