<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Location",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:Location"
  },
  "title" : "Location"
}
-->

# Location

The brand location object.

```
object Location
```

## Discussion

The `Location` object represents a physical brand location sourced from Apple Maps. An `id` identifies each location, and each location belongs to a `brandId`. The `status` field reflects the operational state of the location. Typically, `brands` campaigns target only `OPEN` locations.

The API always returns the `eligibility` field, which describes whether the location can be promoted through ads. Use `categories` to understand the business type, and `address.countryOrRegion` to verify country or region targeting compatibility. The `address` and `displayPoint` provide the geographic data used for map placement rendering.

### Example

```json
{
  "id": "123456789",
  "brandId": "987654321",
  "status": "OPEN",
  "name": "AwayFinder Downtown",
  "categories": [
    "shopping.retail",
    "technology"
  ],
  "address": {
    "countryOrRegion": "US",
    "adminArea": "California",
    "adminAreaCode": "CA",
    "locality": "Cupertino",
    "subLocality": "De Anza",
    "subAdminArea": "Santa Clara County",
    "postalCode": "95014",
    "thoroughfare": "Infinite Loop",
    "subThoroughfare": "1",
    "fullThoroughfare": "1 Infinite Loop",
    "fullAddress": "1 Infinite Loop, Cupertino, California 95014, US",
    "unit": "Suite 100",
    "floor": "1",
    "building": "Main Building"
  },
  "displayPoint": {
    "latitude": "37.3318",
    "longitude": "-122.0312"
  },
  "countryOrRegion": "US",
  "creationTime": "2025-01-10T08:00:00.000",
  "modificationTime": "2025-03-20T14:45:00.000",
  "eligibility": {
    "status": "ELIGIBLE",
    "blockedGroups": [],
    "allowedGroups": [
      {
        "supplyPlacement": [
          "SEARCH_TAB",
          "TODAY_TAB"
        ],
        "countryOrRegion": [
          "US"
        ]
      }
    ]
  }
}
```

## Topics

### Dictionaries

[`object Location.Address`](/documentation/Apple-Ads-Platform-API/Location/Address-data.dictionary)

The postal address of a brand location.

[`object Location.DisplayPoint`](/documentation/Apple-Ads-Platform-API/Location/DisplayPoint-data.dictionary)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)