

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ジオフェンスコレクションリソースを管理する
<a name="managing-geofence-collections"></a>

Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIs を使用して、ジオフェンスコレクションを管理します。

## ジオフェンスコレクションリソースを一覧表示します
<a name="viewing-geofence-collections"></a>

ジオフェンスコレクションリストは、Amazon Location コンソール、 AWS CLI、または Amazon Location APIsを使用して表示できます。

------
#### [ Console ]

**Amazon Location コンソールを使用してジオフェンスコレクションのリストを表示するには**

1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。

1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。

1. [**マイジオフェンスコレクション**] にジオフェンスコレクションのリストが表示されます。

------
#### [ API ]

Amazon Location Geofences API の `[ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html)` オペレーションを使用してください。

次の例は、 AWS アカウント内のジオフェンスコレクションのリストを取得する API リクエストです。

```
POST /geofencing/v0/list-collections
```

以下に、`ListGeofenceCollections` のレスポンスの例を示します。

```
{
    "Entries": [ 
    { 
        "CollectionName": "{{ExampleCollection}}",
        "CreateTime": 2020-09-30T22:59:34.142Z,
        "Description": "string",
        "UpdateTime": 2020-09-30T23:59:34.142Z
    },
    "NextToken": "1234-5678-9012"
}
```

------
#### [ CLI ]

`[list-geofence-collections](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofence-collections.html)` コマンドを使用します。

次の例は、 AWS アカウント内のジオフェンスコレクションのリストを取得 AWS CLI するための です。

```
aws location list-geofence-collections
```

------

## ジオフェンスコレクションの詳細を取得する
<a name="get-geofence-collection-details"></a>

Amazon Location コンソール、、または Amazon Location APIs を使用して AWS CLI、 AWS アカウント内のジオフェンスコレクションリソースの詳細を取得できます。

------
#### [ Console ]

**Amazon Location コンソールを使用してジオフェンスコレクションの詳細を表示するには**

1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。

1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。

1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションの名前リンクを選択します。

------
#### [ API ]

Amazon Location Geofences API の `[DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html)` オペレーションを使用してください。

以下の例は、{{ExampleCollection}} のジオフェンスコレクションの詳細を取得するための API リクエストです。

```
GET /geofencing/v0/collections/{{ExampleCollection}}
```

以下に、`DescribeGeofenceCollection` のレスポンスの例を示します。

```
{
    "CollectionArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GeofenceCollection",
    "CollectionName": "{{ExampleCollection}}",
    "CreateTime": 2020-09-30T22:59:34.142Z,
    "Description": "string",
    "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "Tags": { 
        "Tag1" : "Value1"
    },
    "UpdateTime": 2020-09-30T23:59:34.142Z
}
```

------
#### [ CLI ]

`[describe-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/describe-geofence-collection.html)` コマンドを使用します。

次の例は、{{ExampleCollection}} のジオフェンスコレクションの詳細を取得 AWS CLI するための です。

```
aws location describe-geofence-collection \
    --collection-name "{{ExampleCollection}}"
```

------

## ジオフェンスコレクションを削除する
<a name="delete-geofence-collection"></a>

Amazon Location コンソール、、または Amazon Location APIs を使用して AWS CLI、 AWS アカウントからジオフェンスコレクションを削除できます。

------
#### [ Console ]

**Amazon Location コンソールを使用してジオフェンスコレクションを削除するには**

**警告**  
このオペレーションはリソースを完全に削除します。

 

1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。

1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。

1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションを選択します。

1. [**ジオフェンスコレクションを削除**] を選択します。

------
#### [ API ]

Amazon Location API `[DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html)` のオペレーションを使用してください。

次の例は、ジオフェンスコレクション {{ExampleCollection}} を削除する API リクエストです。

```
DELETE /geofencing/v0/collections/{{ExampleCollection}}
```

以下に、`DeleteGeofenceCollection` のレスポンスの例を示します。

```
HTTP/1.1 200
```

------
#### [ CLI ]

`[delete-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/delete-geofence-collection.html)` コマンドを使用します。

次の例は、ジオフェンスコレクション {{ExampleCollection}} を削除する AWS CLI コマンドです。

```
aws location delete-geofence-collection \
    --collection-name "{{ExampleCollection}}"
```

------

## 保存されているジオフェンスを一覧表示する
<a name="viewing-geofences"></a>

Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIs を使用して、指定されたジオフェンスコレクションに保存されているジオフェンスを一覧表示できます。

------
#### [ Console ]

**Amazon Location コンソールを使用してジオフェンスのリストを表示するには**

1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。

1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。

1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションの名前リンクを選択します。

1. [**ジオフェンス**] で、ジオフェンスコレクション内のジオフェンスを表示します。

------
#### [ API ]

Amazon Location Geofences API の `[ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html)` オペレーションを使用してください。

次の例は、ジオフェンスコレクション {{ExampleCollection}} に保存されているジオフェンスのリストを取得する API リクエストです。

```
POST /geofencing/v0/collections/{{ExampleCollection}}/list-geofences
```

以下に、`ListGeofences` のレスポンスの例を示します。

```
{
   "Entries": [ 
      { 
         "CreateTime": 2020-09-30T22:59:34.142Z,
         "GeofenceId": "geofence-1",
         "Geometry": { 
             "Polygon": [            
                 [-5.716667, -15.933333,
                 [-14.416667, -7.933333],
                 [-12.316667, -37.066667],
                 [-5.716667, -15.933333]
             ]
         },
         "Status": "ACTIVE",
         "UpdateTime": 2020-09-30T23:59:34.142Z
      }
   ],
   "NextToken": "1234-5678-9012"
}
```

------
#### [ CLI ]

`[list-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofences.html)` コマンドを使用します。

次の例は、ジオフェンスコレクション {{ExampleCollection}} に保存されているジオフェンスのリストを取得する AWS CLI です。

```
aws location list-geofences \
    --collection-name "{{ExampleCollection}}"
```

------

## ジオフェンスの詳細を取得する
<a name="get-geofence-details"></a>

Amazon Location コンソールまたは Amazon Location APIs を使用して、ジオフェンスコレクションから、作成時間、更新時間、ジオメトリ、ステータスなど AWS CLI、特定のジオフェンスの詳細を取得できます。

------
#### [ Console ]

**Amazon Location コンソールを使用してジオフェンスのステータスを表示するには**

1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。

1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。

1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションの名前リンクを選択します。

1. [**ジオフェンス**] で、ジオフェンスの状態を表示できます。

------
#### [ API ]

Amazon Location Geofences API の `[GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html)` オペレーションを使用してください。

次の例は、ジオフェンスコレクション {{ExampleCollection}} からジオフェンスの詳細を取得する API リクエストです。

```
GET /geofencing/v0/collections/{{ExampleCollection}}/geofences/{{ExampleGeofence1}}
```

以下に、`GetGeofence` のレスポンスの例を示します。

```
{
   "CreateTime": 2020-09-30T22:59:34.142Z,
   "GeofenceId": "{{ExampleGeofence1}}",
   "Geometry": { 
      "Polygon": [            
          [-1,-1],
          [1,-1],
          [0,1],
          [-1,-1] 
      ]
   },
   "Status": "ACTIVE",
   "UpdateTime": 2020-09-30T23:59:34.142Z
}
```

------
#### [ CLI ]

`[get-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/get-geofence.html)` コマンドを使用します。

次の例は、{{ExampleCollection}} のジオフェンスコレクションの詳細を取得 AWS CLI するための です。

```
aws location get-geofence \
    --collection-name "{{ExampleCollection}}" \
    --geofence-id "{{ExampleGeofence1}}"
```

------

## ジオフェンスを削除する
<a name="delete-geofence"></a>

Amazon Location コンソール、 AWS CLI、または Amazon Location API を使用して、ジオフェンスコレクションからジオフェンスを削除できます。

------
#### [ Console ]

**Amazon Location コンソールを使用してジオフェンスを削除するには**

**警告**  
このオペレーションはリソースを完全に削除します。

 

1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。

1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。

1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションの名前リンクを選択します。

1. [**ジオフェンス**] で、ターゲットジオフェンスを選択します。

1. [**ジオフェンスを削除**] を選択します。

------
#### [ API ]

Amazon Location Geofences API の `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)` オペレーションを使用してください。

次の例は、ジオフェンスコレクション {{ExampleCollection}} からジオフェンスを削除する API リクエストです。

```
POST /geofencing/v0/collections/{{ExampleCollection}}/delete-geofences
Content-type: application/json

{
   "GeofenceIds": [ "{{ExampleGeofence11}}" ]
}
```

以下に、`[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)` の正常なレスポンスの例を示します。

```
HTTP/1.1 200
```

------
#### [ CLI ]

`[batch-delete-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/batch-delete-geofence.html)` コマンドを使用します。

次の例は、ジオフェンスコレクション {{ExampleCollection}} からジオフェンスを削除する AWS CLI コマンドです。

```
aws location batch-delete-geofence \
    --collection-name "{{ExampleCollection}}" \
    --geofence-ids "{{ExampleGeofence11}}"
```

------