Contest Apple override processes for display names (Sensitive Field)

Contest Apple Override of Display Name

Description

Contest an Apple override of a location's display name.

Note: Location's associated brand metadata does not list OVERRIDE__LOCATION_PRIMARY_DISPLAY_NAME

Apple Maps Process

Same process

API User Process

1. API user reads notification/feedback.
2. API user (optionally) uploads a media file.
3. API user contests the Apple override and (optionally) includes the id of the uploaded media file.
4. System validates request (Exception Flows: Apple Override Already Accepted).
5. System synchronously validates the contest details.
6. If no exceptions, then 201 Created is returned.
7. System asynchronously validates the contest details.
8. If no exceptions, then feedback is not generated.
9. System updates the location resource.

• Location resource is versioned (new etag is generated).
• Location resource state is updated to PROCESSING.

10. System waits for Apple Maps review to start.

Apple Maps Contest Review

1. Apple Maps initiates a review.
2. Apple Maps accepts contest value (Exception Flow: Apple Maps Does Not Accept Contest).

Post-conditions

• Apple Maps disables override protection.
• Location resource state is updated from PROCESSING to PUBLISHED
• Apple override resource status is updated from REVIEW_STARTED to ACCEPTED
• Notifications, feedback, and webhook event messages are generated.

Sequence Diagram

Contest Apple Override of Hours or Location Status

Description

Contest an Apple override of a location's hours or location status.

Apple Maps Process

Same process

API User Process

Same process

Apple Maps Contest Review

1. Apple Maps initiates a review.
2. Apple Maps accepts contest value.

Post-conditions

• Apple Maps disables override protection
• Location resource state is updated from PROCESSING to PUBLISHED.
• Apple override's contest status is updated from REVIEW_STARTED to ACCEPTED.
• Notifications, feedback, and webhook event messages are generated.

Subflows

Filter Feedback

See Filter Feedback.

Exception Flows

Apple Maps Does Not Accept Contest

• Apple override status is updated from REVIEW_STARTED to NOT_ACCEPTED.
• Location resource state is updated from PROCESSING to FAILED.
• Apple override "moves" to latest location (etag) version.
• MAPS_DISPLAY notification, feedback, and webhook event messages are (re)generated.

warning

API user must accept the Apple Maps override. Repeated contests will lead to FAILED resource state.

Apple Override Already Accepted

See Filter Feedback.