Skip to content

Conversation

jaclync
Copy link
Contributor

@jaclync jaclync commented Jul 31, 2025

TODOs:

  • Issue number
  • Check performance impact
  • Edge cases:
    • no maps apps available
    • address in non-English

Description

This PR adds a new map display feature for shipping addresses in the order details screen, enhancing the merchant experience when viewing order information. The implementation includes:

  • OrderDetailsShippingAddressMapView: A SwiftUI view that displays the shipping address location on an interactive map
  • OrderDetailsShippingAddressMapViewModel: View model handling geocoding, map state management, and error handling
  • OrderDetailsMapLauncher: Helper class for opening addresses in external mapping applications with support for Apple Maps, Google Maps, and web-based fallbacks

The feature gracefully handles geocoding failures and provides helpful instruction text when location services are unavailable or the address cannot be geocoded.

Steps to reproduce

  1. Navigate to an order with a shipping address in Order Details
  2. Scroll to the shipping address section
  3. View the map display showing the address location
  4. Tap the map to open address in external mapping apps
  5. Test with various address formats and geocoding scenarios

Testing information

Screenshots

Device with both Apple and Google Maps apps:

ScreenRecording_08-01-2025.09-15-13_1.MP4

  • I have considered if this change warrants user-facing release notes and have added them to RELEASE-NOTES.txt if necessary.

@jaclync jaclync added type: enhancement A request for an enhancement. feature: order details Related to order details. labels Jul 31, 2025
@jaclync jaclync added this to the 23.0 milestone Jul 31, 2025
@dangermattic
Copy link
Collaborator

1 Warning
⚠️ This PR is larger than 300 lines of changes. Please consider splitting it into smaller PRs for easier and faster reviews.

Generated by 🚫 Danger

@wpmobilebot
Copy link
Collaborator

App Icon📲 You can test the changes from this Pull Request in WooCommerce iOS Prototype by scanning the QR code below to install the corresponding build.

App NameWooCommerce iOS Prototype
Build Numberpr15963-589f33a
Version22.9
Bundle IDcom.automattic.alpha.woocommerce
Commit589f33a
Installation URL3oeg39b03u400
Automatticians: You can use our internal self-serve MC tool to give yourself access to those builds if needed.

@jaclync jaclync marked this pull request as draft August 1, 2025 01:20
@wpmobilebot wpmobilebot modified the milestones: 23.0, 23.1 Aug 8, 2025
@wpmobilebot
Copy link
Collaborator

Version 23.0 has now entered code-freeze, so the milestone of this PR has been updated to 23.1.

@wpmobilebot wpmobilebot modified the milestones: 23.1, 23.2 Aug 22, 2025
@wpmobilebot
Copy link
Collaborator

Version 23.1 has now entered code-freeze, so the milestone of this PR has been updated to 23.2.

@wpmobilebot wpmobilebot modified the milestones: 23.2, 23.3 Sep 5, 2025
@wpmobilebot
Copy link
Collaborator

Version 23.2 has now entered code-freeze, so the milestone of this PR has been updated to 23.3.

@iangmaia iangmaia modified the milestones: 23.3, 23.4 Sep 19, 2025
@iangmaia
Copy link
Contributor

Version 23.3 has now entered code-freeze, so the milestone of this PR has been updated to 23.4.

@staskus staskus modified the milestones: 23.4, 23.5 Oct 3, 2025
@wpmobilebot wpmobilebot modified the milestones: 23.5, 23.6 Oct 17, 2025
@wpmobilebot
Copy link
Collaborator

Version 23.5 has now entered code-freeze, so the milestone of this PR has been updated to 23.6.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature: order details Related to order details. type: enhancement A request for an enhancement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants