Skip to main content

Apple Business guidance for capturing a location's operational status

Location Status

Closed

  • MUST be used to communicate a location that has permanently closed
  • closedDate MUST NOT be a future date
  • A CLOSED location MAY be updated to OPEN
    • The updated location MUST describe the same physical/conceptual location when CLOSED
warning

The ability to re-open a location is only expected to be used when CLOSED was set by mistake. It must not be used to re-use the same location's address to describe a different operation. For example, the resource describing a pharmacy that has closed cannot be updated to open a sandwich shop. The sandwich shop is a new location.

Opening Soon

  • openingDate MUST be a future date
  • openingDate MUST NOT be more than one hundred and eighty (180) days into future

Temporarily Closed

Use TEMPORARILY_CLOSED when:

  • Location is not operational due to construction, remodeling, natural disaster, or public health emergency.
  • reopenDate MUST be a future date
  • RECOMMENDED: When reopenDate is uncertain, set date six (6) months into the future

Do not use when location:

  • Changes its hours or services, but some services remain open.
  • Has seasonal hours such as schools and skiing resorts. Use special hours
  • Closed due to labor disputes
NameDescription
LocationLocation API