Interface Place.Builder
-
- All Superinterfaces:
Buildable,CopyableBuilder<Place.Builder,Place>,SdkBuilder<Place.Builder,Place>,SdkPojo
- Enclosing class:
- Place
public static interface Place.Builder extends SdkPojo, CopyableBuilder<Place.Builder,Place>
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description Place.BuilderaddressNumber(String addressNumber)The numerical portion of an address, such as a building number.Place.Buildercategories(String... categories)The Amazon Location categories that describe this Place.Place.Buildercategories(Collection<String> categories)The Amazon Location categories that describe this Place.Place.Buildercountry(String country)A country/region specified using ISO 3166 3-digit country/region code.default Place.Buildergeometry(Consumer<PlaceGeometry.Builder> geometry)Sets the value of the Geometry property for this object.Place.Buildergeometry(PlaceGeometry geometry)Sets the value of the Geometry property for this object.Place.Builderinterpolated(Boolean interpolated)Trueif the result is interpolated from other known places.Place.Builderlabel(String label)The full name and address of the point of interest such as a city, region, or country.Place.Buildermunicipality(String municipality)A name for a local area, such as a city or town name.Place.Builderneighborhood(String neighborhood)The name of a community district.Place.BuilderpostalCode(String postalCode)A group of numbers and letters in a country-specific format, which accompanies the address for the purpose of identifying a location.Place.Builderregion(String region)A name for an area or geographical division, such as a province or state name.Place.Builderstreet(String street)The name for a street or a road to identify a location.Place.BuildersubMunicipality(String subMunicipality)An area that's part of a larger municipality.Place.BuildersubRegion(String subRegion)A county, or an area that's part of a larger region.Place.BuildersupplementalCategories(String... supplementalCategories)Categories from the data provider that describe the Place that are not mapped to any Amazon Location categories.Place.BuildersupplementalCategories(Collection<String> supplementalCategories)Categories from the data provider that describe the Place that are not mapped to any Amazon Location categories.default Place.BuildertimeZone(Consumer<TimeZone.Builder> timeZone)The time zone in which thePlaceis located.Place.BuildertimeZone(TimeZone timeZone)The time zone in which thePlaceis located.Place.BuilderunitNumber(String unitNumber)For addresses with multiple units, the unit identifier.Place.BuilderunitType(String unitType)For addresses with aUnitNumber, the type of unit.-
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
-
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
-
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
-
-
-
Method Detail
-
label
Place.Builder label(String label)
The full name and address of the point of interest such as a city, region, or country. For example,
123 Any Street, Any Town, USA.- Parameters:
label- The full name and address of the point of interest such as a city, region, or country. For example,123 Any Street, Any Town, USA.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
geometry
Place.Builder geometry(PlaceGeometry geometry)
Sets the value of the Geometry property for this object.- Parameters:
geometry- The new value for the Geometry property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
geometry
default Place.Builder geometry(Consumer<PlaceGeometry.Builder> geometry)
Sets the value of the Geometry property for this object. This is a convenience method that creates an instance of thePlaceGeometry.Builderavoiding the need to create one manually viaPlaceGeometry.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed togeometry(PlaceGeometry).- Parameters:
geometry- a consumer that will call methods onPlaceGeometry.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
geometry(PlaceGeometry)
-
addressNumber
Place.Builder addressNumber(String addressNumber)
The numerical portion of an address, such as a building number.
- Parameters:
addressNumber- The numerical portion of an address, such as a building number.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
street
Place.Builder street(String street)
The name for a street or a road to identify a location. For example,
Main Street.- Parameters:
street- The name for a street or a road to identify a location. For example,Main Street.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
neighborhood
Place.Builder neighborhood(String neighborhood)
The name of a community district. For example,
Downtown.- Parameters:
neighborhood- The name of a community district. For example,Downtown.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
municipality
Place.Builder municipality(String municipality)
A name for a local area, such as a city or town name. For example,
Toronto.- Parameters:
municipality- A name for a local area, such as a city or town name. For example,Toronto.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subRegion
Place.Builder subRegion(String subRegion)
A county, or an area that's part of a larger region. For example,
Metro Vancouver.- Parameters:
subRegion- A county, or an area that's part of a larger region. For example,Metro Vancouver.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
region
Place.Builder region(String region)
A name for an area or geographical division, such as a province or state name. For example,
British Columbia.- Parameters:
region- A name for an area or geographical division, such as a province or state name. For example,British Columbia.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
country
Place.Builder country(String country)
A country/region specified using ISO 3166 3-digit country/region code. For example,
CAN.- Parameters:
country- A country/region specified using ISO 3166 3-digit country/region code. For example,CAN.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
postalCode
Place.Builder postalCode(String postalCode)
A group of numbers and letters in a country-specific format, which accompanies the address for the purpose of identifying a location.
- Parameters:
postalCode- A group of numbers and letters in a country-specific format, which accompanies the address for the purpose of identifying a location.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
interpolated
Place.Builder interpolated(Boolean interpolated)
Trueif the result is interpolated from other known places.Falseif the Place is a known place.Not returned when the partner does not provide the information.
For example, returns
Falsefor an address location that is found in the partner data, but returnsTrueif an address does not exist in the partner data and its location is calculated by interpolating between other known addresses.- Parameters:
interpolated-Trueif the result is interpolated from other known places.Falseif the Place is a known place.Not returned when the partner does not provide the information.
For example, returns
Falsefor an address location that is found in the partner data, but returnsTrueif an address does not exist in the partner data and its location is calculated by interpolating between other known addresses.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
timeZone
Place.Builder timeZone(TimeZone timeZone)
The time zone in which the
Placeis located. Returned only when using HERE or Grab as the selected partner.- Parameters:
timeZone- The time zone in which thePlaceis located. Returned only when using HERE or Grab as the selected partner.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
timeZone
default Place.Builder timeZone(Consumer<TimeZone.Builder> timeZone)
The time zone in which the
This is a convenience method that creates an instance of thePlaceis located. Returned only when using HERE or Grab as the selected partner.TimeZone.Builderavoiding the need to create one manually viaTimeZone.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed totimeZone(TimeZone).- Parameters:
timeZone- a consumer that will call methods onTimeZone.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
timeZone(TimeZone)
-
unitType
Place.Builder unitType(String unitType)
For addresses with a
UnitNumber, the type of unit. For example,Apartment.Returned only for a place index that uses Esri as a data provider.
- Parameters:
unitType- For addresses with aUnitNumber, the type of unit. For example,Apartment.Returned only for a place index that uses Esri as a data provider.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
unitNumber
Place.Builder unitNumber(String unitNumber)
For addresses with multiple units, the unit identifier. Can include numbers and letters, for example
3BorUnit 123.Returned only for a place index that uses Esri or Grab as a data provider. Is not returned for
SearchPlaceIndexForPosition.- Parameters:
unitNumber- For addresses with multiple units, the unit identifier. Can include numbers and letters, for example3BorUnit 123.Returned only for a place index that uses Esri or Grab as a data provider. Is not returned for
SearchPlaceIndexForPosition.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
categories
Place.Builder categories(Collection<String> categories)
The Amazon Location categories that describe this Place.
For more information about using categories, including a list of Amazon Location categories, see Categories and filtering, in the Amazon Location Service Developer Guide.
- Parameters:
categories- The Amazon Location categories that describe this Place.For more information about using categories, including a list of Amazon Location categories, see Categories and filtering, in the Amazon Location Service Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
categories
Place.Builder categories(String... categories)
The Amazon Location categories that describe this Place.
For more information about using categories, including a list of Amazon Location categories, see Categories and filtering, in the Amazon Location Service Developer Guide.
- Parameters:
categories- The Amazon Location categories that describe this Place.For more information about using categories, including a list of Amazon Location categories, see Categories and filtering, in the Amazon Location Service Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
supplementalCategories
Place.Builder supplementalCategories(Collection<String> supplementalCategories)
Categories from the data provider that describe the Place that are not mapped to any Amazon Location categories.
- Parameters:
supplementalCategories- Categories from the data provider that describe the Place that are not mapped to any Amazon Location categories.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
supplementalCategories
Place.Builder supplementalCategories(String... supplementalCategories)
Categories from the data provider that describe the Place that are not mapped to any Amazon Location categories.
- Parameters:
supplementalCategories- Categories from the data provider that describe the Place that are not mapped to any Amazon Location categories.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subMunicipality
Place.Builder subMunicipality(String subMunicipality)
An area that's part of a larger municipality. For example,
Blissvilleis a submunicipality in the Queen County in New York.This property supported by Esri and OpenData. The Esri property is
district, and the OpenData property isborough.- Parameters:
subMunicipality- An area that's part of a larger municipality. For example,Blissvilleis a submunicipality in the Queen County in New York.This property supported by Esri and OpenData. The Esri property is
district, and the OpenData property isborough.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-