Package software.amazon.awscdk.services.location

Class CfnPlaceIndex

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.CfnElement
software.amazon.awscdk.CfnRefElement
software.amazon.awscdk.CfnResource
software.amazon.awscdk.services.location.CfnPlaceIndex
All Implemented Interfaces:
IInspectable, IEnvironmentAware, IPlaceIndexRef, ITaggableV2, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)", date="2025-11-13T16:10:08.891Z") @Stability(Stable) public class CfnPlaceIndex extends CfnResource implements IInspectable, IPlaceIndexRef, ITaggableV2
Specifies a place index resource in your AWS account.

Use a place index resource to geocode addresses and other text queries by using the SearchPlaceIndexForText operation, and reverse geocode coordinates by using the SearchPlaceIndexForPosition operation, and enable autosuggestions by using the SearchPlaceIndexForSuggestions operation.

If your application is tracking or routing assets you use in your business, such as delivery vehicles or employees, you must not use Esri as your geolocation provider. See section 82 of the AWS service terms for more details.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.location.*;
 CfnPlaceIndex cfnPlaceIndex = CfnPlaceIndex.Builder.create(this, "MyCfnPlaceIndex")
         .dataSource("dataSource")
         .indexName("indexName")
         // the properties below are optional
         .dataSourceConfiguration(DataSourceConfigurationProperty.builder()
                 .intendedUse("intendedUse")
                 .build())
         .description("description")
         .pricingPlan("pricingPlan")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();

See Also:

  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.

  • Constructor Details

    • CfnPlaceIndex

      protected CfnPlaceIndex(software.amazon.jsii.JsiiObjectRef objRef)

    • CfnPlaceIndex

      protected CfnPlaceIndex(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • CfnPlaceIndex

      @Stability(Stable) public CfnPlaceIndex(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull CfnPlaceIndexProps props)
      Create a new AWS::Location::PlaceIndex.

      Parameters:
      scope - Scope in which this resource is defined. This parameter is required.
      id - Construct identifier for this resource (unique in its scope). This parameter is required.
      props - Resource properties. This parameter is required.

  • Method Details

    • fromIndexName

      @Stability(Stable) @NotNull public static IPlaceIndexRef fromIndexName(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull String indexName)
      Creates a new IPlaceIndexRef from a indexName.

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      indexName - This parameter is required.

    • fromPlaceIndexArn

      @Stability(Stable) @NotNull public static IPlaceIndexRef fromPlaceIndexArn(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull String arn)
      Creates a new IPlaceIndexRef from an ARN.

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      arn - This parameter is required.

    • inspect

      @Stability(Stable) public void inspect(@NotNull TreeInspector inspector)
      Examines the CloudFormation resource and discloses attributes.

      Specified by:
      inspect in interface IInspectable
      Parameters:
      inspector - tree inspector to collect and process attributes. This parameter is required.

    • renderProperties

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.

    • getAttrArn

      @Stability(Stable) @NotNull public String getAttrArn()
      The Amazon Resource Name (ARN) for the place index resource. Used to specify a resource across AWS .

      • Format example: arn:aws:geo:region:account-id:place-index/ExamplePlaceIndex

    • getAttrCreateTime

      @Stability(Stable) @NotNull public String getAttrCreateTime()
      The timestamp for when the place index resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ .

    • getAttrIndexArn

      @Stability(Stable) @NotNull public String getAttrIndexArn()
      Synonym for Arn .

      The Amazon Resource Name (ARN) for the place index resource. Used to specify a resource across AWS .

      • Format example: arn:aws:geo:region:account-id:place-index/ExamplePlaceIndex

    • getAttrUpdateTime

      @Stability(Stable) @NotNull public String getAttrUpdateTime()
      The timestamp for when the place index resource was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ .

    • getCdkTagManager

      @Stability(Stable) @NotNull public TagManager getCdkTagManager()
      Tag Manager which manages the tags for this resource.
      Specified by:
      getCdkTagManager in interface ITaggableV2

    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource

    • getPlaceIndexRef

      @Stability(Stable) @NotNull public PlaceIndexReference getPlaceIndexRef()
      A reference to a PlaceIndex resource.
      Specified by:
      getPlaceIndexRef in interface IPlaceIndexRef

    • getDataSource

      @Stability(Stable) @NotNull public String getDataSource()
      Specifies the geospatial data provider for the new place index.

    • setDataSource

      @Stability(Stable) public void setDataSource(@NotNull String value)
      Specifies the geospatial data provider for the new place index.

    • getIndexName

      @Stability(Stable) @NotNull public String getIndexName()
      The name of the place index resource.

    • setIndexName

      @Stability(Stable) public void setIndexName(@NotNull String value)
      The name of the place index resource.

    • getDataSourceConfiguration

      @Stability(Stable) @Nullable public Object getDataSourceConfiguration()
      Specifies the data storage option requesting Places.

      Returns union: either IResolvable or CfnPlaceIndex.DataSourceConfigurationProperty

    • setDataSourceConfiguration

      @Stability(Stable) public void setDataSourceConfiguration(@Nullable IResolvable value)
      Specifies the data storage option requesting Places.

    • setDataSourceConfiguration

      @Stability(Stable) public void setDataSourceConfiguration(@Nullable CfnPlaceIndex.DataSourceConfigurationProperty value)
      Specifies the data storage option requesting Places.

    • getDescription

      @Stability(Stable) @Nullable public String getDescription()
      The optional description for the place index resource.

    • setDescription

      @Stability(Stable) public void setDescription(@Nullable String value)
      The optional description for the place index resource.

    • getPricingPlan

      @Stability(Stable) @Nullable public String getPricingPlan()
      No longer used.

      If included, the only allowed value is RequestBasedUsage .

    • setPricingPlan

      @Stability(Stable) public void setPricingPlan(@Nullable String value)
      No longer used.

      If included, the only allowed value is RequestBasedUsage .

    • getTags

      @Stability(Stable) @Nullable public List<CfnTag> getTags()
      An array of key-value pairs to apply to this resource.

    • setTags

      @Stability(Stable) public void setTags(@Nullable List<CfnTag> value)
      An array of key-value pairs to apply to this resource.