プレイアブル ロケーション エクスプローラは、Playable Locations API の検索リクエストを作成してテストできるウェブアプリです。検索結果が視覚的に示される（S2 セル内にあるプレイアブル ロケーションが表示される）ため、クエリを簡単に作成して特定のゲームに最適なプレイアブル ロケーションを検索することができます。
地域検索
新しい検索を開始するには、地図の上部にある検索フィールドに、検索する場所の住所を入力します。たとえば、「75 9th Avenue, New York, NY, United States」と入力すると、エクスプローラがその場所の地理座標を取得して、その領域をカバーする S2 セルを計算します。そして、それぞれプレイアブル ロケーションを表す小さな色付きのアイコンが S2 セルに入力されます。
プレイアブル ロケーションのプロパティ
プレイアブル ロケーションをクリックすると、そのプロパティを含む情報ウィンドウが表示されます。
PlaceId とラベル付けされたプロパティは、場所に関する追加情報を返す Place Details リクエストにリンクしています。
不適切な場所の報告
不適切な場所とは、ゲームプレイに不適切と見なされるプレイアブル ロケーションです。次のような場合は、プレイアブル ロケーションが不適切と見なすことができます。
- 徒歩でアクセスできない
- 一般に公開されていない
- 閉業
- 一時的にアクセス不可
不適切な場所に関する報告は Google のデータチームに送られ、優先度に基づいて 1 日以内に処理されます。既存の報告をエスカレーションする場合や、ステータスをフォローアップする場合は、Google Cloud Platform Console のヘルプからサポートケースを送信できます。サポートケースを送信する際は、削除する場所の PlaceId を必ず指定してください。
不適切な場所を報告するには
不適切なプレイアブル ロケーションを Google に報告する手順は次のとおりです。
- 地図上で、不適切な場所として報告するプレイアブル ロケーションをクリックします。その場所のプロパティ ページが表示されます。
- プロパティ ページの上部に、リンク [Report as Bad Location] が表示されます。これをクリックします。[Report Bad Location] ダイアログが表示されます。
![[Report Bad Location] ダイアログ](https://developers.google.com/static/maps/documentation/gaming/tt/images/report_bad_location3.png?hl=ja)
- 不適切なプレイアブル ロケーションの報告の優先度を選択します。優先度 P0 と P1 の報告は、サービスレベル契約（SLA）に沿って応答時間が 24 時間に設定され、直ちに審査が必要な緊急性の高い報告として予約されます。
例P0 および P1 の報告のシナリオの例を次のリストに示します。
- P0
- 個人の安全に危険が及ぶ。たとえば、次のようなプレイアブル ロケーションが該当します。
- 崖の縁までの距離が 50 メートルに満たない。
- 幹線道路の真ん中にある。
- P1
- 立ち入りが不法侵入と見なされる。たとえば、次のようなプレイアブル ロケーションが該当します。
- 軍事基地内にある。
- オーナーがゲームからロケーションを削除するようリクエストしているスポットの近くにある。
- プレイアブル ロケーションが不適切と見なされるいずれかの理由を選択してください。
- 理由が「一時的にアクセス不可」または「その他」の場合は、[Report Details] に詳細を追加します。
- [Submit a Bad Location Report] をクリックします。
S2 セルのレベル
S2 セルのレベルを使用して、プレイアブル ロケーションを返す領域を指定できます。デフォルトのレベルは 12 です。最小レベルは 11（最大領域のカバー範囲）、最大レベルは 16（最小領域のカバー範囲）です。
API リクエスト / レスポンスを表示する
この機能を設定すると、Playable Locations API に送られる HTTP リクエストと返される HTTP レスポンスを確認できます。それには、[Show API Request / Response] をクリックします。
ドライブに保存する
HTTP リクエストを Google ドライブに保存するには、[Save to Drive] をクリックします。ファイルは playable_locations-v3-request.json という名前になります。
クリップボードにコピーする
HTTP リクエストをクリップボードにコピーするには、[Copy] をクリックします。
独自の認証情報を使用する
プレイアブル ロケーション エクスプローラでは API キーは事前設定されていますが、本番環境で HTTP リクエスト メッセージを再利用するには、HTTP リクエストで独自のキーを使用する必要があります。エクスプローラで作成した HTTP リクエストを簡単に再利用できるようにするには、独自のキーを使用するようエクスプローラを設定します。それには、[Open Credentials] をクリックし、Google Cloud Platform の認証情報コンソールで API キーのリストからキーを選択します。
エクスプローラ
このセクションでは、プレイアブル ロケーション エクスプローラの API v3 バージョンの機能について説明します。
条件を追加する
ゲーム オブジェクト タイプごとに条件のセットを設定できます。個別の条件を追加するには、[Add criterion] をクリックします。[Add Criterion] ダイアログが表示されます。
条件の設定が完了したら、[Save criterion] をクリックします。
ゲーム オブジェクト名
条件を作成するには、まず[Enter a name for your Game Object] フィールドに、この条件を設定するゲーム オブジェクトの名前を入力します。
ゲーム オブジェクト タイプのアイコン
Criterion ダイアログの右上には正方形のアイコンがあり、右側にプルダウン セレクタが表示されます。これを使用して、このゲーム オブジェクト タイプのアイコンを選択できます。
ゲーム オブジェクト タイプのアイコンの色
ゲーム オブジェクト タイプのアイコンの色を選択するには、色選択ツールを使用します。色選択ツールは、ゲーム オブジェクト タイプのセレクタの下にある小さな色付きのディスクです。
フィールド
検索で返すプレイアブル ロケーションのフィールドを選択するには、フィールド機能を使用します。
フィルタ
検索フィルタを設定するには、フィルタ機能を使用します。
| フィルタ | 説明 |
|---|---|
| 最大ロケーション数 | このゲーム オブジェクト タイプで返すプレイアブル ロケーションの最大数。 |
| 最小間隔（メートル単位） | このゲーム オブジェクト タイプの 2 つのプレイアブル ロケーションの間の最短距離。 |
| ポイントの種類 | プレイアブル ロケーションを配置する場所を指定します。場所の中心点、または最も近い道路の歩道にスナップされた場所の位置です。 |
| コンテンツのレーティング | Playable Locations API は、あらゆる年齢層のプレーヤーの使用に適しているプレイアブル ロケーションをデフォルトで提供しますが、ゲームが成人のプレーヤーのみを対象としている場合は、この機能を使用して、年齢制限のある場所（バー、カジノ、ナイトクラブなど）に関連するプレイアブル ロケーションを含めることができます。 |
| アクセスタイプ | 場所の利用要件です。 |
ランク付け
検索結果をランク付けするための重み付け要素を設定するには、ランク付け機能を使用します。この機能を使うと、複数のランク付け要素に基づいて、プレイアブル ロケーションを強調して表示したり目立たないようにしたりできます。
| ランク付けの要素 | 説明 |
|---|---|
| 混雑状況 | にぎわっているプレイアブル ロケーションと、あまり活動が行われていないプレイアブル ロケーションのいずれかを優先します。にぎわっているロケーションのほうが混雑度は高くなります。 |
| 収容人数の多い会場 | 大規模な人数を収容できる会場を優先します。 |
| 滞在時間が長い | ユーザーが比較的長時間にわたって滞在する傾向があるプレイアブル ロケーションを優先します。 |
| 芸術的な関心度 | ユーザーが芸術的関心を寄せている場所を優先します。 |
場所タイプ
検索結果に含めるか除外するプレイアブル ロケーションのタイプは、ここで選択できます。デフォルトでは、すべてのプレイアブル ロケーションのタイプが含まれます。
各種の知名度に基づく調整比
各種の知名度に基づく調整比を使用すると、特定の種類のプレイアブル ロケーションについて、知名度の重み付けを調整できます。たとえば、「{park: 2, cinema: 3, bank: -1}」のように指定できます。この場合、公園の知名度は 2、映画館については 3 引き上げられ、銀行の知名度は 1 引き下げられます。値は -10～+10 の範囲で指定できます。
除外ポイント
ご自身のコンテンツがプレイアブル ロケーションに重ならないようにするには、検索結果から除外するポイントを指定します。それには、除外する地図上のポイントをクリックし、表示されるスライダーを使用して、除外する領域の境界線を定義する円の半径を設定します。