---
title: PlaceDescriptor
framework: geotoolbox
role: symbol
role_heading: Structure
path: geotoolbox/placedescriptor
---

# PlaceDescriptor

A structure that contains identifying information about a place that a mapping service may use to attempt to find rich place information such as phone numbers, websites, and so on.

## Declaration

```swift
struct PlaceDescriptor
```

## Discussion

Discussion A PlaceDescriptor allows you to construct a collection of metadata about a place, including at least one PlaceDescriptor.PlaceRepresentation which contains common geographic concepts like an address or coordinate. PlaceDescriptor may optionally include a supportingRepresentations which contains identifiers that match the place for mapping service providers. Use PlaceDescriptor in conjunction with a mapping service to request rich information about a place. For example to create a PlaceDescriptor that describes an address with a common name use init(representations:commonName:supportingRepresentations:) as shown here.     let fountain = PlaceDescriptor(         representations: [.address("121-122 James's St \n Dublin 8 \n D08 ET27 \n Ireland")],         commonName: "Obelisk Fountain"     ) You can also initialize a PlaceDescriptor using an MKMapItem as shown below.     guard let descriptor = PlaceDescriptor(item: myMapItem) else {         return     }

## Topics

### Creating place descriptors

- [init(representations:commonName:supportingRepresentations:)](geotoolbox/placedescriptor/init(representations:commonname:supportingrepresentations:).md)
- [init(item:)](geotoolbox/placedescriptor/init(item:).md)

### Getting the attributes of a place descriptor

- [commonName](geotoolbox/placedescriptor/commonname.md)
- [address](geotoolbox/placedescriptor/address.md)
- [coordinate](geotoolbox/placedescriptor/coordinate.md)
- [representations](geotoolbox/placedescriptor/representations.md)
- [supportingRepresentations](geotoolbox/placedescriptor/supportingrepresentations.md)
- [serviceIdentifier(for:)](geotoolbox/placedescriptor/serviceidentifier(for:).md)

### Enumeration values that describe places and mapping service representations

- [PlaceDescriptor.PlaceRepresentation](geotoolbox/placedescriptor/placerepresentation.md)
- [PlaceDescriptor.SupportingPlaceRepresentation](geotoolbox/placedescriptor/supportingplacerepresentation.md)

### Type Aliases

- [PlaceDescriptor.Specification](geotoolbox/placedescriptor/specification.md)
- [PlaceDescriptor.UnwrappedType](geotoolbox/placedescriptor/unwrappedtype.md)
- [PlaceDescriptor.ValueType](geotoolbox/placedescriptor/valuetype.md)

### Type Properties

- [defaultResolverSpecification](geotoolbox/placedescriptor/defaultresolverspecification.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [CustomLocalizedStringResourceConvertible](foundation/customlocalizedstringresourceconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Decodable](swift/decodable.md)
- [DisplayRepresentable](appintents/displayrepresentable.md)
- [Encodable](swift/encodable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [InstanceDisplayRepresentable](appintents/instancedisplayrepresentable.md)
- [IntentValueConvertible](appintents/intentvalueconvertible.md)
- [IntentValueExpressing](appintents/intentvalueexpressing.md)
- [PersistentlyIdentifiable](appintents/persistentlyidentifiable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)
- [TypeDisplayRepresentable](appintents/typedisplayrepresentable.md)
