---
title: Understanding Locations
framework: Apple Ads Platform API
role: collectionGroup
role_heading: API Collection
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/locations-overview
---

# Understanding Locations

Query and inspect the business locations associated with your brand for use in Apple Maps campaigns.

## Overview

Overview A location represents a physical place of business, such as a retail store, restaurant, or service center. Ads on Apple Maps promote these locations. See Managing Location Groups for how a location group organizes locations into a targetable set for an ad group. Locations are read-only from the API perspective. Apple Business, not the Apple Ads Platform API, creates and maintains them. Use the location endpoints to discover locations associated with your brand, verify eligibility, and retrieve location IDs for use in location group construction. Understand Key Concepts Familiarize yourself with these concepts before you query locations or build location groups:  |   |   |   |   |   |  Follow the Location Workflow Use location endpoints to discover and validate locations before building location groups for an Apple Maps campaign: Query locations for a brand. Call Query for Locations with a brandId filter to retrieve all locations associated with your brand. Note the id value of each location you want to target. Filter by status. Add a status EQUALS OPEN filter to return only locations that are eligible for ad targeting. You can’t add closed or temporarily closed locations to location groups. Verify eligibility. Check the eligibility.status field in each location object. A location must have eligibility.status: ELIGIBLE before you can add it to a location group and use it in a campaign. Retrieve a single location. Call Get a Location by id to confirm address, coordinates, and eligibility before adding the location to a group. Build and manage location groups. Once you’ve verified location IDs, see Managing Location Groups for the full group creation, targeting, and maintenance workflow. Review Location Fields Each location object returned by the API includes these read-only fields:  |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |

## Topics

- [Query for Locations](apple-ads-platform-api/query-locations.md)
- [Get a Location](apple-ads-platform-api/get-location-by-id.md)

## See Also

### Ads on Apple Maps

- [Ads on Apple Maps Endpoints](apple-ads-platform-api/brands-endpoints.md)
- [Managing Location Groups](apple-ads-platform-api/location-groups-overview.md)
- [Brands Data Objects](apple-ads-platform-api/brands-data-objects.md)
- [Brands Data Types](apple-ads-platform-api/brands-data-types.md)