メソッド: generateTerritories

指定された S2 セルのテリトリーを生成します。このテリトリーは、S2 セルをほぼカバーするだけです。隣接するセルに対して返されるテリトリーは、重複しないよう照合されます。

HTTP リクエスト

POST https://playablelocations.googleapis.com/v3:generateTerritories

この URL では gRPC Transcoding 構文を使用します。

リクエスト本文

リクエストの本文には次の構造のデータが含まれます。

JSON 表現

{
  "s2CellId": string,
  "territorySizeSquareMeters": number,
  "subterritoryCount": number,
  "snapshotId": string
}
フィールド
s2CellId

string (fixed64 format)

テリトリーで(ほぼ)カバーされる S2 セル。

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

現在、レベル 11 の S2 セルのみがサポートされています(約 20 平方キロメートル)。* S2 セルの統計情報

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

territorySizeSquareMeters

number

リクエストされたテリトリーの大きさ(平方メートル単位)。

subterritoryCount

number

各テリトリーを分割する下位テリトリーの数。一部のテリトリーでは、下位テリトリーがリクエストした数よりも少なくなる場合があります。

snapshotId

string

前の v3.generateTerritories リクエストで返される任意のスナップショット ID。指定した場合、この ID はテリトリーの構成要素の過去のスナップショットをマッピングするために使用されます。指定しなかった場合は最新のスナップショットが使用され、その ID がレスポンスで返されます。

レスポンス本文

成功すると、レスポンス本文に次の構造のデータが含まれます。

v3.generateTerritories メソッドに対するレスポンス。

JSON 表現

{
  "territories": [
    {
      object (Territory)
    }
  ],
  "snapshotId": string
}
フィールド
territories[]

object (Territory)

指定された S2 セルをほぼカバーするテリトリー。

snapshotId

string

スナップショット ID。この ID は、このリクエストでグループ化に使用されたテリトリーの構成要素の過去のスナップショットを示します。返されるスナップショット ID を、後続の v3.generateTerritories リクエストのパラメータとして指定すると、同じスナップショットから新たなテリトリーを生成できます。

Territory

ゲームのテリトリー。

JSON 表現

{
  "polygons": [
    {
      object (Polygon)
    }
  ],
  "subterritories": [
    {
      object (Territory)
    }
  ]
}
フィールド
polygons[]

object (Polygon)

テリトリーのポリゴン。

subterritories[]

object (Territory)

このテリトリーの下位テリトリー。

Polygon

外側の境界線リングとホールリングで表される、ホールを含むポリゴン。どちらの場合も、頂点を順に移動する場合は、ポリゴンの内側が左側になります。つまり頂点は、外側の境界線では反時計回り、ホールでは時計回りの順になります。

JSON 表現

{
  "outerBoundary": {
    object (Ring)
  },
  "holes": [
    {
      object (Ring)
    }
  ]
}
フィールド
outerBoundary

object (Ring)

ポリゴンの外側の境界線を定義するリング。リングの頂点を順に移動する場合は、ポリゴンの内側が外側の境界線の左側になります。つまり、リングの頂点は反時計回りの順になります。

holes[]

object (Ring)

ポリゴンのホール。それぞれのリングでは、リングの頂点を順に移動する場合はポリゴンの内側がリングの左側になります。つまり、リングの頂点は時計回りの順になります。

Ring

閉じたポリラインのリング。個々のリングの最後の頂点は、最初の頂点に暗黙的に結合されます。

JSON 表現

{
  "vertices": [
    {
      object (LatLng)
    }
  ]
}
フィールド
vertices[]

object (LatLng)

リングの頂点。