Overview
Zebra Mobile Parcel provides and easy and accurate way to capture parcel dimensions on-demand using an integrated time-of-flight sensor. This document is intended for application designers and developers who utilize the Application Programming Interface (API) to develop mobile parcel dimensioning applications for commercial use on compatible Zebra devices. The information in this guide is specifically focused on API usage.
Mobile Parcel Demo Video
Requirements
- Android 11, 13 or 14
- See Zebra Support Portal for the supported devices list
- The Dimensioning Framework, pre-installed on supported Zebra mobile computers. For updates, visit the Zebra Support Portal.
New in Mobile Parcel 2.2
This release applies exclusively to standard (non-certified) Mobile Parcel Dimensioning.
- Introduced an “accept” button to the “NoDim” result screen, replacing the previous method of using the back arrow to accept results. This ensures consistency with the typical dimension confirmation and facilitates sending results back to the app.
- Introduced the “OptimizeForSpeed” configuration option, which disables certain protections designed to reject lower confidence results, allowing for faster processing with a potential reduction in accuracy.
- Implemented a feature for storing dimension results, enabling logging and providing a user interface for viewing or exporting the data set based on DIMENSION_ID.
- API Updates:
- Deprecated intents: The “com.zebra.parceldimensioning” intents are now deprecated and replaced by “com.zebra.dimensioning” intents.
- Updated parameters: In the Get Dimension API,
PARCEL_IDhas been deprecated and replaced withOBJECT_ID. - Modified error conditions: In the Enable Dimension response, several
RESULT_CODEerror conditions are moved from “FAILED” to “ERROR.” - Added response keys: The keys
LEGAL_FOR_TRADEandDIMENSION_IDare now included in the Get Dimension response.
- Resolved Issues:
PARCEL_IDis no longer missing from theGET_DIMENSIONresponse.- Images are no longer incorrectly rotated when returned by Dimensioning.
- The “About” screen no longer incorrectly displays “null” versions.
- Dimensioning accuracy for cylindrical and other targets has been improved.
- Fixed an issue where dimensioning failed under certain floor conditions.
- The blue segmentation mask will now only appear when the target parcel is fully visible within the field of view (FOV).
- Known Issues:
- Android split screen is not supported with the dimensioning solution.
- The camera might fail if accessed within 60 seconds of device bootup.
- Downgrading to Mobile Parcel 1.2 (or earlier) is not permitted on devices running Android 13 or 14.
Version History
New in Mobile Parcel 2.0
This release applies exclusively to standard (non-certified) Mobile Parcel Dimensioning.
- The CALLBACK_RESPONSE key is now optional for DISABLE_DIMENSION.
- Two new keys, OBJECT_TYPE and MESSAGE, are added to the GET_DIMENSION response.
- Added support for volumetric weight in the demo application.
New in Mobile Parcel 1.4
This release applies to both Certified (legal for trade certifications) and standard (non-certified) Mobile Parcel Dimensioning.
- Added support for Android 14; see Zebra Support Portal for the supported devices list.
- Token API Disabled By Default: While the API interface was originally secured with an API token, this method is no longer included as a standard feature due to its added complexity. Developers who still need to use the API token can contact Zebra Technical Support.
New in Mobile Parcel 1.3
This release applies to both Certified (legal for trade certifications) and standard (non-certified) Mobile Parcel Dimensioning.
- Added Support for Android 13. See Zebra Support Portal for the supported devices list.
- If upgrading from Android 11 to Android 13, it is required to upgrade the dimensioning software to version 1.3 before upgrading the device; see Mobile Parcel 1.3 Release Notes for more details.
- The TIMESTAMP for GET_DIMENSION is now reported with microsecond precision instead of second precision.
- New TIMEOUT parameter added in GET_DIMENSION_PARAMETER and SET_DIMENSION_PARAMETER.
- New feature to remove the “Not Legal for Trade” banner by editing the NLFT_Banner configuration file.
New in Mobile Parcel 1.2
This release applies to exclusively to standard (non-certified) Mobile Parcel Dimensioning.
- Added Support for TC73 and TC78 mobile computers.
New in Mobile Parcel 1.1
This release applies exclusively to Certified (legal for trade certifications) Mobile Parcel Dimensioning. Certification is hardware-dependent.
- Initial Release of Certified Mobile Parcel Dimensioning.