---
title: LocationGroup
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/locationgroup
---

# LocationGroup

A collection of business locations associated with a brand, used to target geos in Apple Maps campaigns.

## Declaration

```data
object LocationGroup
```

## Properties

id: ID of the location group. Read-only. name: Display name of the location group. brandId: Associated brand identifier. adAccountId: Ad account ID that owns this location group. groupType: Type of location grouping. Values: STATIC, DYNAMIC. See groupType Details in LocationGroupCreate. systemStatus: System-managed status. Values: PENDING, VALID, INVALID, DELETED. Read-only. rules: Array of Rule objects defining membership criteria for DYNAMIC groups. query: RSQL query string generated from rules for DYNAMIC groups. Generated by the server. Don’t set directly. Read-only. locationIds: Array of location IDs for STATIC groups. isAllLocationsGroup: true for the system-created “All Locations” group for a brand. Read-only. description: Optional description of the location group. groupTotal: Total number of locations in the group. Read-only. eligibility: Eligibility status for this location group. See Eligibility. Read-only. creationTime: Timestamp when the group was created. Read-only. modificationTime: Timestamp of the last modification. Read-only.

## Discussion

Discussion The LocationGroup object is a targeting unit that bundles one or more brand locations under a named group. It only scopes which locations are in play. Creatives, bids, and budget remain set on the ad group or ad itself, not per location group. Example {   "id": "5764607523034238976",   "name": "AwayFinder West Coast Stores",   "brandId": "9151314442816847872",   "adAccountId": "293897290",   "groupType": "DYNAMIC",   "systemStatus": "VALID",   "rules": [     {       "field": "adminArea",       "operator": "IN",       "value": ["California", "Oregon", "Washington"]     }   ],   "query": "administrativeArea==California,Oregon,Washington",   "locationIds": [],   "isAllLocationsGroup": false,   "description": "All AwayFinder locations on the West Coast",   "groupTotal": 42,   "eligibility": {     "status": "ELIGIBLE"   },   "creationTime": "2026-02-01T09:00:00.000",   "modificationTime": "2026-03-25T16:00:00.000" }

## See Also

- [Brand](apple-ads-platform-api/brand.md)
- [BrandResponse](apple-ads-platform-api/brandresponse.md)
- [BrandQueryResponse](apple-ads-platform-api/brandqueryresponse.md)
- [BrandRejectionReasonResponse](apple-ads-platform-api/brandrejectionreasonresponse.md)
- [BusinessCategory](apple-ads-platform-api/businesscategory.md)
- [BusinessCategoryResponse](apple-ads-platform-api/businesscategoryresponse.md)
- [BusinessCategoryQueryResponse](apple-ads-platform-api/businesscategoryqueryresponse.md)
- [Location](apple-ads-platform-api/location.md)
- [LocationResponse](apple-ads-platform-api/locationresponse.md)
- [LocationGroupCreate](apple-ads-platform-api/locationgroupcreate.md)
- [LocationGroupUpdate](apple-ads-platform-api/locationgroupupdate.md)
- [LocationGroupResponse](apple-ads-platform-api/locationgroupresponse.md)
- [LocationGroupQueryResponse](apple-ads-platform-api/locationgroupqueryresponse.md)
- [LocationQueryResponse](apple-ads-platform-api/locationqueryresponse.md)
- [Eligibility](apple-ads-platform-api/eligibility.md)