Contents

BusinessCategory

A category in the Apple Maps business taxonomy used to classify brands and locations.

Declaration

object BusinessCategory

Properties

NameTypeDescription
id Requiredstring

MUID (Maps Unique Identifier) for this category. Read-only.

namestring

English locale display name of the category. Example: "Association or Organization". Read-only.

qualifiedIdstring

Dot-delimited taxonomy path encoding the category hierarchy. A dot always marks a hierarchy boundary, but an individual level’s name can itself contain underscores (for example, association_or_organization). Example: "dining.restaurant". Use this value as the text on a CATEGORY match-type Keyword. Read-only.

descriptionstring

Human-readable description of the category. Example: "Sporting venues where animals are involved." Read-only.

eligibilityEligibility

Ad serving eligibility for this category. See Eligibility. Read-only.

Discussion

The BusinessCategory object represents a leaf or branch node in the Apple Maps category taxonomy. Categories classify brands and locations and scope which businesses Apple Maps campaigns can reach.

You can associate active Apple Maps campaigns only with categories that have eligibility.status: ELIGIBLE. Check eligibility before using a category in a production campaign.

Example

{
  "id": "cat-restaurant-042",
  "name": "Restaurant",
  "qualifiedId": "dining.restaurant",
  "description": "Establishments that prepare and serve food and beverages to customers.",
  "eligibility": {
    "status": "ELIGIBLE",
    "blockedGroups": [],
    "allowedGroups": [
      {
        "supplyPlacement": ["SEARCH_TAB", "SEARCH_RESULTS"],
        "countryOrRegion": ["US", "GB"]
      }
    ],
    "modificationTime": "2025-01-10T08:00:00.000"
  }
}

See Also