---
title: Managing Location Groups
framework: Apple Ads Platform API
role: collectionGroup
role_heading: API Collection
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/location-groups-overview
---

# Managing Location Groups

Organize business locations into named groups that define which locations an ad group’s targeting applies to in Apple Maps campaigns.

## Overview

Overview A location group is a named collection of business locations associated with a brand. Instead of targeting every location a brand operates, you can define groups (such as all locations in a metro area, a specific region, or a custom set for a promotional push) and apply that group to an ad group’s targeting configuration. The location group only scopes which locations are in play. You set the schedule, creatives, and bids on the ad group or ad itself, not per location group. A location group doesn’t affect which viewers see the ad or how close they are to any given location. Geo and radius targeting on the ad group control that separately. Understand Key Concepts The following terms explain how location groups fit into your targeting strategy:  |   |   |   |   |  Follow the Workflow Use location groups to build a targeted geographic strategy for an Apple Maps campaign: Discover locations. Call Query for Locations with a brandId filter to retrieve locations for your brand. Note the id values of the locations you want to group. Create the group. Call Create Location Group with a name, the brandId, and an array of locationIds. The STATIC groups (built from an explicit locationIds list) are VALID immediately. The DYNAMIC groups (built from rules) start in PENDING state while the system evaluates membership. Wait for systemStatus: VALID before using a DYNAMIC group in targeting. Verify the group. Call Get Location Group to confirm the group was created correctly and all location IDs are present. Target the group. Reference the location group ID in the targeting parameters of an ad group. That restricts delivery for the ad group to the locations in the group. Maintain the group. As brand footprint changes (new store openings, closures, seasonal popups), update the group using Update Location Group to add or remove location IDs without rebuilding your campaign structure. For DYNAMIC groups, the system automatically adds new locations that satisfy the group’s rules, so they don’t require a manual update. Remove unused groups. When a group is no longer needed, call Delete Location Group to clean up. Deletion is permanent. Ad groups targeting a deleted group lose that targeting constraint immediately and continue to serve only if they also target other location groups. Review Location Group Fields A location group object exposes the following fields:  |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |  Note Group Size Limits Location groups enforce the following limits on size and structure: An organization can have a maximum of 5000 location groups across all its brands. An ad group can target a maximum of 25 location groups. A dynamic location group can include a maximum of 25 rules. There’s no limit on the number of locations a static location group can include, or on the number of locations attached to a campaign through location groups. Locations are defined at the brand level, so any location added to a brand is available to include in that brand’s groups.

## Topics

- [Create Location Group](apple-ads-platform-api/create-location-group.md)
- [Query Location Groups](apple-ads-platform-api/query-location-groups.md)
- [Get Location Group](apple-ads-platform-api/get-location-group-by-id.md)
- [Update Location Group](apple-ads-platform-api/update-location-group.md)
- [Delete Location Group](apple-ads-platform-api/delete-location-group.md)

## See Also

### Ads on Apple Maps

- [Ads on Apple Maps Endpoints](apple-ads-platform-api/brands-endpoints.md)
- [Understanding Locations](apple-ads-platform-api/locations-overview.md)
- [Brands Data Objects](apple-ads-platform-api/brands-data-objects.md)
- [Brands Data Types](apple-ads-platform-api/brands-data-types.md)