メソッド: searchPlayableLocations

string (fixed64 format)

必須。目的の領域の S2 セル ID。セルのレベルを 11～16 の範囲で指定する必要があります。

S2 セルは、Earth での領域を識別する 64 ビットの整数です。これらは階層構造になっているため、空間インデックスに使用できます。

S2 ジオメトリ ライブラリは、次の複数の言語で使用できます。

• C++
• Java
• Go
• Python

object (PointExclusion)

プレイアブル ロケーションを検索する際に除外するプレイアブル ロケーションを指定します。たとえば、ゲームですでに使用されているロケーションを、ユーザーが作成した「基地」や「補給庫」に基づいて除外することができます。

string (fixed64 format)

必須。検索結果から除外するリーフ S2 セルの ID。このフィールドを使用して、ご自身のコンテンツとプレイアブル ロケーションが重ならないようにすることができます。

number

除外する S2 セルの周囲の最小間隔。

プレイアブル ロケーションはこの半径の範囲内に配置されなくなります。

integer

必須。プレイアブル ロケーションが使用されるゲーム オブジェクトのタイプについてデベロッパーが定義する任意の識別子。このフィールドを使用して、プレイアブル ロケーションを検索する際の条件をゲーム オブジェクト タイプごとに指定できます。

タイプが異なるゲーム オブジェクトは、プレーヤーが操作する方法も異なるため、このフィールドによって目的のデータ分析で使用するインプレッション データを分離することができます。

異なるタイプのゲーム オブジェクトを表すには、すべての request_criteria に一意の gameObjectType ID を割り当てる必要があります。たとえば、「1=monster location」、「2=powerup location」のように割り当てます。

レスポンスには map<gameObjectType, Response> が含まれます。

object (Filter)

フィルタ オプションと検索結果のセットに含める要素を指定します。

object (Ranking)

プレイアブル ロケーションをランク付けする方法を指定します。

string (FieldMask format)

どの PlayableLocation フィールドを返すかを指定します。

name（インプレッションの記録に使用されます）、center_point、place_id（または plus_code）は常に返されます。

次のフィールドは、ここで指定しない限り省略されます。

• addresses
• biome_type
• display_names
• snapped_point
• types

注: 含めるフィールドが多くなるほど、データや関連するレイテンシによってクエリにかかる費用は高くなります。

完全修飾されたフィールド名のカンマ区切りリスト（例: "user.displayName,photo"）。

integer

返されるプレイアブル ロケーションの最大数を指定します。この値は 1,000 以内で指定する必要があります。デフォルト値は 100 です。

ランク付けが上位のプレイアブル ロケーションのみが返されます。

object (SpacingOptions)

プレイアブル ロケーションの間隔を調整するオプションのセット。

string

プレイアブル ロケーションのセットを目的のタイプのみに限定します。

string

不要なプレイアブル ロケーションのタイプを除外します。

このフィールドは、includedTypes より優先順位が高くなります。

enum (ContentRating)

年齢制限のある場所（バー、カジノ、ナイトクラブなど）に関連するプレイアブル ロケーションを含めるオプションを指定します。

デフォルト値は、プレイアブル ロケーションがすべての年齢層に適していることを意味する EVERYONE です。

enum (AccessType)

場所に関連付けられたアクセスタイプを指定する値。AccessType 列挙値の 1 つとして指定されます。

このフィールドを使用して、FREE（公園など）や PAID（遊園地など）の領域内のプレイアブル ロケーションをフィルタできます。デフォルト値は FREE です。このフィルタは生成されたロケーションにのみ適用されます。

enum (BiomeType)

プレイアブル ロケーションのセットを特定の生物群系タイプのみに限定します。

object (ProximityOptions)

付近の場所タイプに関する情報をリクエストする、または付近の場所タイプまでの距離を指定する際に使用できるオプションのセット（最大 10 個）。

number

必須。2 つのプレイアブル ロケーションの最小間隔（メートル単位）。最小値は 10、最大値は 1000 です。

プレイアブル ロケーションが密集しないようにするには、このフィールドを設定します。

注:

間隔の計算では貪欲アルゴリズムが使用されます。このアルゴリズムでは、最大限に多くのロケーションを選択するのではなく、まず最もランク付けが高いロケーションを選定するよう最適化が行われます。次のシナリオを考えてみます。

• ランク: A: 2、B: 1、C: 3。
• 距離: A -- 20 m -- B -- 20 m -- C

間隔が 25 の場合は、[A] や [C] ではなく、最もランク付けの高い場所である [B] が選定されます。

注:

間隔は、ゲーム オブジェクト タイプ自体と、その前のゲーム オブジェクト タイプに適用されます。たとえば、3 つのゲーム オブジェクト タイプで、それぞれ以下の間隔が指定されているとします。

• X: 100 m、Y: 未定義、Z: 50 m。

1. X のロケーションを、各オブジェクトから 100 m の範囲内に追加します。
2. Y のロケーションを間隔なしで追加します。
3. 最後に、Z のロケーションも X と Y からそれぞれ 50 m の範囲内に追加します。

これらのロケーションの間の距離関係は次のようになります。

• 起点 -> 終点
• X -> X: 100 m
• Y -> X、Y -> Y: 未指定。
• Z -> X、Z -> Y、Z -> Z: 50 m。

enum (PointType)

プレイアブル ロケーションの中心点またはスナップ ポイントに最小間隔の制限を適用するかどうかを指定します。デフォルト値は CENTER_POINT です。

プレイアブル ロケーションのスナップ ポイントを使用できない場合は、中心点が代用されます。

ゲームで使用されるポイントの種類に設定します。この設定は、PointExclusion と ProximityOptions の距離を計算する際にも使用されます。

string

必須。プレイアブル ロケーションの maxDistanceMeters 内で検索するプレイスタイプのセット。プレイアブル ロケーションの種類のリストで指定されているタイプである必要があります。

number

必須。このプレイアブル ロケーションの半径（メートル単位）の範囲内で、指定されたプレイスタイプを検索します。値は 10～1,000 メートルの範囲で指定する必要があります。

リクエストされた S2 セルの近隣セルのみが検索されます。遠距離を設定した場合は、検索の対象が実質的にそれらのセルの範囲に制限されます。

enum (Mode)

近隣オプションを情報提供のために使用するか、それともプレイアブル ロケーションをフィルタするために使用するかを指定します。デフォルト値は INFORMATION です。

map (key: string, value: integer)

プレイアブル ロケーションの特定の種類の重み付けを調整できます。望ましい種類の重み付けを増やすには正の値を使用し、そうでない種類の重み付けを減らすには負の値を指定します。

たとえば、「{park: 2, cinema: 3, bank: -1}」のように指定できます。この場合、公園の重み付けは 2、映画館については 3 増え、銀行の重み付けは 1 減ります。値は -10～+10 の範囲で指定できます。

複数のマッチング タイプに該当するプレイアブル ロケーションのスコア調整には、指定された中で最も大きい値が使用されます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }。

object (Busyness)

プレイアブル ロケーションの混雑度を指定します。

object (Capacity)

大規模な場所の収容人数を指定します。

このランク付けの調整比は現在サポートされていませんが、フィードバックをお寄せくださいますようお願いいたします。

object (Dwellability)

場所の平均滞在時間を指定します。

このランク付けの調整比は現在サポートされていませんが、フィードバックをお寄せくださいますようお願いいたします。

object (ArtisticallyInteresting)

場所に対して芸術的関心がどの程度寄せられているかを指定します。

enum (BusynessModifier)

アクティビティ レベルに基づくランク付けの調整比を、BusynessModifier 列挙値の 1 つとして指定します。

busyness 値を指定しなかった場合、この調整比はプレイアブル ロケーションのランク付けに使用されなくなります。

enum (CapacityModifier)

収容人数に基づくランク付けの調整比を、CapacityModifier 列挙値の 1 つとして指定します。

capacity 値を指定しなかった場合、この調整比はプレイアブル ロケーションのランク付けに使用されなくなります。

enum (DwellabilityModifier)

滞在時間の長さに基づくランク付け調整比を、DwellabilityModifier 列挙値の 1 つとして指定します。

dwellability 値を指定しなかった場合、この調整比はプレイアブル ロケーションのランク付けに使用されなくなります。

enum (ArtisticallyInterestingModifier)

artisticallyInteresting 値を指定しなかった場合、この調整比はプレイアブル ロケーションのランク付けに使用されなくなります。