Apple Override
Overview
Apple Override is a feature that provides actionable information to Apple Business organizations and their delegated partners when Apple overrides location attributes. Maintaining accurate business information across Apple services is crucial for customer engagement and trust. Apple Override Feedback helps you ensure your listings are accurate, giving you control over your brand's location data on Apple Maps.
Understanding Apple Overrides
An Apple override occurs when Apple edits location data that was originally provided by a business owner or a partner granted Share Access through delegation or OAuth.
This can happen for various reasons, such as:
- Customer feedback.
- Data collected from other sources such as other data providers, websites, for example.
Attributes Subject to Overrides
Apple Override Feedback is available for the following location attributes:
- Display Name
- Location Status
- Hours of Operation, including Service Hours and Special Hours
Retrieving Apple Overrides
Partners are notified of Apple overrides either through our Notifications API or webhook. Please refer to API documentation on querying for notifications or support for webhooks for API Users.
API Endpoints for Retrieving Overrides for Specific Locations
Use these API to retrieve override information:
- Get Apple Overrides - Retrieve a list of Apple overrides for your locations.
- Get Apple Override by ID - Retrieve a specific Apple override using its ID.
Responding to Apple Overrides
Partners have two options when responding to an Apple override
Accepting an Override
Use the Accept API to accept the Apple override.
Contesting an Override
Use the Contest API to contest the Apple override. When you contest an override:
- You must provide an alternate value (response value) for the attribute.
- For attributes like Display Name, you have the option to provide supporting documentation.
- For Location Status, Hours of Operation, Service Hours, and Special Hours, if validations pass, your response value is published.
- For Display Name, additional review is required by Apple.
- Override state is changed to
SUBMITTED.
Validation Requirements
When contesting an override, your alternate value is validated:
Best Practices for Managing Apple Overrides
Timely Responses
Respond to Apple overrides promptly to ensure your business information remains accurate across Apple services. The Apple override value will remain in effect until either a user responds to the Apple override or a new Apple override is generated superseding the older Apple override.
Use Case Documentation
For detailed guidance on handling overrides of specific attributes, see:
API Integration Considerations
When integrating Apple Override Feedback into your platform:
- Ensure your platform can display override information to your client organizations.
- Provide clear options for accepting or contesting overrides.
- Update your stored data when overrides are accepted to avoid sending outdated information in future updates.
- Monitor Maps Display Notifications.
Troubleshooting
If you encounter issues:
- Verify that you're using the correct override ID when responding.
- Ensure response values meet Apple Business data requirements as specified in the validation documentation.
- For Display Name, provide clear supporting documentation when contesting.
For additional assistance, contact Business API Support.