:doc:`LocationService <../../location>` / Client / create_geofence_collection

**************************
create_geofence_collection
**************************



.. py:method:: LocationService.Client.create_geofence_collection(**kwargs)

  

  Creates a geofence collection, which manages and stores geofences.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreateGeofenceCollection>`_  


  **Request Syntax**
  ::

    response = client.create_geofence_collection(
        CollectionName='string',
        PricingPlan='RequestBasedUsage'|'MobileAssetTracking'|'MobileAssetManagement',
        PricingPlanDataSource='string',
        Description='string',
        Tags={
            'string': 'string'
        },
        KmsKeyId='string'
    )
    
  :type CollectionName: string
  :param CollectionName: **[REQUIRED]** 

    A custom name for the geofence collection.

     

    Requirements:

     

    
    * Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_).
     
    * Must be a unique geofence collection name.
     
    * No spaces allowed. For example, ``ExampleGeofenceCollection``.
    

    

  
  :type PricingPlan: string
  :param PricingPlan: 

    No longer used. If included, the only allowed value is ``RequestBasedUsage``.

    

  
  :type PricingPlanDataSource: string
  :param PricingPlanDataSource: 

    This parameter is no longer used.

    

  
  :type Description: string
  :param Description: 

    An optional description for the geofence collection.

    

  
  :type Tags: dict
  :param Tags: 

    Applies one or more tags to the geofence collection. A tag is a key-value pair helps manage, identify, search, and filter your resources by labelling them.

     

    Format: ``"key" : "value"``

     

    Restrictions:

     

    
    * Maximum 50 tags per resource
     
    * Each resource tag must be unique with a maximum of one value.
     
    * Maximum key length: 128 Unicode characters in UTF-8
     
    * Maximum value length: 256 Unicode characters in UTF-8
     
    * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @.
     
    * Cannot use "aws:" as a prefix for a key.
    

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  :type KmsKeyId: string
  :param KmsKeyId: 

    A key identifier for an `Amazon Web Services KMS customer managed key <https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html>`__. Enter a key ID, key ARN, alias name, or alias ARN.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'CollectionName': 'string',
          'CollectionArn': 'string',
          'CreateTime': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **CollectionName** *(string) --* 

        The name for the geofence collection.

        
      

      - **CollectionArn** *(string) --* 

        The Amazon Resource Name (ARN) for the geofence collection resource. Used when you need to specify a resource across all Amazon Web Services.

         

        
        * Format example: ``arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection``
        

        
      

      - **CreateTime** *(datetime) --* 

        The timestamp for when the geofence collection was created in `ISO 8601 <https://www.iso.org/iso-8601-date-and-time-format.html>`__ format: ``YYYY-MM-DDThh:mm:ss.sssZ``

        
  
  **Exceptions**
  
  *   :py:class:`LocationService.Client.exceptions.InternalServerException`

  
  *   :py:class:`LocationService.Client.exceptions.ConflictException`

  
  *   :py:class:`LocationService.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`LocationService.Client.exceptions.ValidationException`

  
  *   :py:class:`LocationService.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`LocationService.Client.exceptions.ThrottlingException`

  