ZEBRA MN-004417-03EN Dimensioning Mobile Parcel User Guide

ZEBRA MN-004417-03EN Dimensioning Mobile Parcel

Product Information

Specifications

• Product: Zebra Dimensioning Mobile Parcel
• User Guide: MN-004417-03EN Rev A
• Copyright: 2023/09/19
• Manufacturer: Zebra Technologies Corporation

Product Usage Instructions

About This Guide
This guide provides information on using the Zebra Parcel Dimensioning solution. It includes notational conventions, an overview, and term definitions related to the product.

Notational Conventions
The guide uses specific notations to convey information effectively. Pay attention to symbols, formatting, and terms used throughout the manual for proper product usage.

Overview
The Zebra Parcel Dimensioning solution enables users to capture dimensions of parcels by aiming the dimensioning device at them. The Mobile Dimensioning (MD) Client is a demonstration app that calls the dimensioning service using the MD API for testing and demonstration purposes.

Term Definitions

• Dimension Capture: The process of obtaining length, width, and height dimensions by aiming the dimensioning device at a parcel.
• Mobile Dimensioning (MD) Client: A demonstration app that calls the dimensioning service using the MD API for testing and demonstration purposes.
• LOB App: An app developed using the MD API customized for a specific business need.
• Dimensioning Service: The software performing parcel measurement. When called by a LOB app, it provides an active user interface for dimension capture.

Dimensioning Flow
The dimensioning flow involves aiming the device at a parcel to capture its dimensions using the Dimensioning Service. Follow the steps outlined in the user guide to ensure accurate dimension capture.

FAQ

• Can the Zebra Dimensioning Mobile Parcel be used for irregularly shaped parcels?
  The device is designed to capture dimensions of standard rectangular parcels accurately. For irregular shapes, manual adjustments may be needed.

• How do I calibrate the dimensioning device?
  Refer to the user manual for specific instructions on calibrating the device to ensure precise measurements.

Copyright

• ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in many jurisdictions worldwide. All other trademarks are the property of their respective owners. ©2023 Zebra Technologies Corporation and/or its affiliates. All rights reserved.
• Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of those agreements.
• For further information regarding legal and proprietary statements, please go to:
  • SOFTWARE: zebra.com/linkoslegal.
  • COPYRIGHTS: zebra.com/copyright.
  • PATENTS: ip.zebra.com.
  • WARRANTY: zebra.com/warranty.
  • END USER LICENSE AGREEMENT: zebra.com/eula.

Terms of Use

Proprietary Statement
This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of parties operating and maintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed to any other parties for any other purpose without the express, written permission of Zebra Technologies.

Product Improvements
Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs are subject to change without notice.

Liability Disclaimer
Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals are correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and disclaims liability resulting therefrom.

Limitation of Liability
In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the accompanying product (including hardware and software) be liable for any damages whatsoever (including, without limitation, consequential damages including loss of business profits, business interruption, or loss of business information) arising out of the use of, the results of use of, or inability to use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you.

About This Guide

The guide discusses the Zebra non-certified parcel dimensioning solution and the Mobile Dimensioning (MD) client. The MD Client provides dimension capture capabilities, demonstrating a line-of-business (LOB) app calling the dimensioning service using the MD application program interface (API). The MD Client is provided by default on select premium Zebra Android™ mobile computers.
For general information on how to use your Zebra mobile computer, refer to the product reference guide for your device.

Notational Conventions
The following conventions are used in this document:

• Bold text is used to highlight the following:
  • Dialog box, window, and screen names
  • Dropdown list and list box names
  • Checkbox and radio button names
  • Icons on a screen
  • Key names on a keypad
  • Button names on a screen
• Bullets (•) indicate:
  • Action items
  • List of alternatives
  • Lists of required steps that are not necessarily sequential.
• Sequential lists (for example, those that describe step-by-step procedures) appear as numbered lists.

Overview

• The Zebra non-certified parcel dimensioning solution provides fast and accurate point-and-shoot dimensioning using an integrated time of flight sensor with no external snap-on sensors required.
• The non-certified mobile parcel dimensioning solution provides the same performance as the certified versions. However, it does not have the software sealing features required for certification and Weights and Measures requirements. For these reasons, the solution cannot be used as legal-for-trade.
• Parcel dimensioning is available for premium mobile computers that feature a time-of-flight (ToF) camera. The following models are supported:
  • TC53 (Premium only)
  • TC58 (Premium only)
  • TC73 (Premium only)
  • TC78 (Premium only)
• A mobile dimensioning application comes pre-installed on supported models to demonstrate how a line-of-business (LOB) application can use the outputs from the mobile dimensioning framework.
• The resolution for dimension results is 0.1 cm for metric and 0.1 in. for imperial units.

Term Definitions

This section describes the terms used in this guide as they relate to the Zebra Parcel Dimensioning solution.

Dimension Capture
The process of aiming the dimensioning device at a parcel and obtaining length, width, and height dimensions.

Mobile Dimensioning (MD) Client

• The MD Client is a demonstration of a LOB app calling the dimensioning service using the MD API.
• The app allows for testing and demonstration of dimension capture.

LOB App
An app developed using the MD API that is customized for a specific business need.

Dimensioning Service
The combination of software that performs the parcel measurement. When the dimensioning service is called by a LOB app, it presents a user interface that is active for the entire dimension capture.

Length
The larger of the horizontal dimensions of the parcel. It is represented in inches or centimeters (user-configurable).

Width
The smaller of the horizontal dimensions of the parcel. It is represented in inches or centimeters (user-configurable).

Height
The vertical dimension of the parcel above the supporting surface. It is represented in inches or centimeters (user-configurable).

Minimum Bounding Box (MBB)
A rectangular cuboidal construct represents the minimum cuboidal volume occupied by the parcel.

Out of Range
For non-certified parcel dimensioning, measurements are out of range when smaller than 10 cm (4 in.) or larger than 120 cm (48 in.).

Dimension Capture

For the optimal dimension capturing experience, the following sections provide information about dimensioning use cases, aiming methods, tips, and limitations of the framework.

Parcel Use Cases

The Zebra parcel dimensioning solution only supports cuboidal parcels placed on a flat surface.

Supported Parcels and Environments
Supported parcels and environments include cuboidal parcels placed on a flat surface.

1. Regular cuboid (cardboard, wood, plastic)
2. Clear wrap
3. Non-black wrap
4. Countertop
5. Multiple parcels
6. Label, tape, graphics
7. Indoor lighting
8. Outdoor lighting

Unsupported Parcels and Environments
Unsupported parcels and environments include irregular shapes, envelopes, and handheld parcels.

1. Black wrap or parcel Non-reflective surface
2. Transparent
3. Envelopes or flat parcels
4. Handheld parcels
5. Non-cuboidal
6. Conveyor belts
7. Black surfaces
8. Palletized freight
9. Metallic tape Highly reflective surface
10. Irregular shapes
11. Weight scale

Dimension Aiming Methods

For the optimal dimensioning results, always make sure that the entire parcel is visible in the Viewfinder.

1. Top-down view on floor
2. Top-down view on countertop
3. Angled view on floor
4. Angled view on countertop

Viewfinder Orientation

• Make sure to align the longest edge of the parcel with the longest edge of the Viewfinder.
• Use portrait mode when aiming at the smaller side of the parcel. For example, when dimensioning tall parcels.
• Use landscape mode when facing the larger side of the parcel. For example, when dimensioning wide parcels.
• Change between portrait and landscape orientation by rotating the device. From the portrait orientation, rotate the device counterclockwise to change to landscape orientation. From landscape orientation, rotate the device clockwise to move back to portrait orientation.
• When the device orientation is changed, the user interface automatically rotates to the current orientation even if the auto-rotate setting is disabled on the device. This is required for dimensioning to function properly.

Top-Down Method
The preferred method for parcel dimensioning is to aim straight down from above the parcel.

• Place the on-screen aimer on the middle of the top surface of the parcel.
• Make sure that there is a minimum of 20 cm (7.9 in.) of floor or counter space visible around all sides of the target parcel.
• When multiple parcels are in the Viewfinder, use the on-screen aimer to identify the target parcel.
• Avoid glare from parcel surfaces by tilting the device slightly.

Angled Method
When a top-down view of the parcel is not possible, dimensioning can be performed using an angled method. For this method, it is preferred to aim the Viewfinder at an angle that captures the top and one full side of the parcel.

• Place the on-screen aimer on the top surface of the parcel while keeping the entire parcel visible in the Viewfinder.
• Make sure that there is a minimum of 20 cm (7.9 in.) of floor or counter space around all visible sides of the target parcel.
• When multiple parcels are in the Viewfinder, use the on-screen aimer to identify the target parcel.

Tips for Optimal Dimensioning

To optimize your dimensioning performance, follow these recommended tips.

Minimum Range

• It is recommended that the distance to a parcel be at least 40 cm (16 in.).
• This is important when dimensioning small boxes. If aiming top-down at close range there may be too much IR glare directed at the dimensioning device. It is visible on the display as a light colored area.
• When this happens, tilt the dimensioning device slightly to move the glare off of the parcel’s top surface.
• The glare spot is easily visible in the first image below. The second image shows the result of tilting the dimensioning device leading to a successful dimension in the third image.

Tall Parcels and Countertop Dimensioning

• To successfully dimension a parcel, point the on-screen aimer at the top of the parcel. Aim directly above the parcel as much as possible (within 50° of vertical).
• If the parcel is very tall or the counter height makes it difficult for the user to fit the entire parcel within the viewfinder, rotate the parcel so that the smallest dimension is the height.
• The following figure illustrates turning a box onto its side, allowing the user a better view of the parcel. The user is able to fit the entire parcel on the screen and point the on-screen aimer at the top of the parcel.
  1. Entire parcel is not in the viewfinder
  2. Entire parcel is in the viewfinder

Alignment of Parcels within the Viewfinder
The optimal results are obtained when the largest horizontal edge of the parcel is aligned with the largest dimension of the display. This is achieved by using the portrait device orientation when standing next to the smaller side of the parcel and using the landscape device orientation when standing next to the longer side of the parcel.

Dimensioning with Multiple Devices

• When using multiple devices to perform dimensioning in close proximity, make sure not to overlap the field-of-views.
• As part of the dimensioning process, the ToF camera uses illumination that is not visible to the naked eye.
• No dimensions are captured when the illumination coming from two or more nearby devices overlaps.
  1. Overlapping field-of-views
  2. Separated field-of-views

Multiple Parcels in the Field-of-View
When more than one parcel is in the field-of-view, fill the screen as much as possible with the intended target. Ensure that the aimer is centered on top of the intended target during the dimensioning process.

Bounding Lines
Bounding lines that match the edges of the parcel indicate a good result. If bounding lines do not match the edges of the parcel, the user should retry.

Operation in Sunlight
Avoid dimensioning a parcel where the sun is directly in front of you. Dimension with the sun at your back, place the parcel in the shade, or use a top-down view.

Distance to Other Objects
Make sure there is a minimum of 20 cm (7.9 in.) between the target parcel and walls or objects the same height or taller. For large parcels that require an angled view, the time-of-flight signal may be impacted by an adjacent wall or object that is too close to the target parcel.

Limitations

The dimensioning framework can handle a wide range of parcels, with the following limitations.

Black Surfaces
The 3D sensor cannot reliably detect black surfaces. Under the following conditions, parcel dimensioning attempts timeout to a NoDim (no dimension) result.

• Black parcels – This includes parcels wrapped in black material.
• Black floor – The floor must be recognized for dimensions to be calculated. Dimensioning on grey surfaces, such as asphalt, should be possible even in sunny conditions.
• Black tape – This applies to black tape on the top edges of the parcel. You can dimension parcels with black tape across the middle by making sure the aimer is not on the black tape. If the aimer is on the black tape, the parcel may not be dimensioned.

Highly Reflective Surfaces (Specular Reflection)
The 3D sensor cannot reliably dimension with highly reflective surfaces such as shiny metal walls or mirrorlike reflective surfaces that produce a specular reflection. The user must dimension the targeted parcel with these surfaces outside the field-of-view of the camera (i.e., not within the viewfinder display).

• Shiny metal walls and floor – mostly unpainted bare metal that produces a mirror-like reflection
• Shiny containers – metal containers next to the target parcel
• Mirrored walls
• Metal tape – this applies to metal tape on the visible surfaces or edges of the parcel.

Long or Thin Parcels
Parcels where one dimension is near the maximum and one dimension is near the minimum may lead to a

NoDim (no dimension) result.
For example, a parcel measuring 100 x 15 x 15 cm may not produce a dimensioning result. However, a parcel measuring 50 x 15 x 15 cm should produce a result.

Directional Feedback
To receive directional feedback, the dimensioning service must be able to identify that there is a parcel in the field-of-view.

• If the device is too close to the parcel, move further away until the entire parcel is visible in the Viewfinder. The ToF camera cannot dimension a parcel closer than the minimum range of the ToF camera . Also, when the device is too close to the parcel, it can cause glare, which can interfere with dimensioning.
• If the device is too far from the parcel, move closer and fill more of the display area with the parcel.
• If the dimensioning angle is too steep, move or tilt the device to keep the angle within 50° of the topdown (0%) position. The device provides tilt feedback when the angle is too steep.

Application Interactions

• Google Voice Assistant – Google Voice Assistant will not launch when the dimensioning screen is active.
• Repeated Rotations – Repeatedly rotating the dimensioning device may cause the Mobile Dimensioning demonstration client Start Dimensioning button to be grayed out. Restart the application to clear the condition.
• Repeated Open/Close of the Mobile Dimensioning demonstration application – Repeated opening and closing of the application in quick succession may cause the Mobile Dimensioning demonstration client Start Dimensioning button to be grayed out. Restart the application to clear the condition.
• Split screen mode – Android Split Screen mode is not supported.
• Guest mode – Android Guest mode is not supported.

Mobile Dimensioning Client

The MD Client demonstrates parcel dimensioning and allows developers to test a sample LOB app that calls the dimensioning service using the MD API.

Mobile Dimensioning Client User Interface

• The MD Client provides a sample user interface (UI) that allows end-users to perform dimensioning capture and view the dimension results.
• The MD Client is an example of a line-of-business customer app and may only be used for demonstration and testing of the dimensioning solution.
  1| Menu – Select to display relevant information about the device, app, and framework.
  ---|---
  2| BoxID – Displays optional box identification.
  ---|---
  3| Scan Barcode button – Use to scan a barcode that fills the BoxID field with a barcode value.
  4| Save Image checkbox – Use to save an image of the final dimensioning result.
  5| Measurement units – Select to display dimensions in inches or centimeters. The default is based on the current location of the device and may not be available in all locations.
  6| Dimensions – Displays the dimension values.

•         Zero values – Initial value before dimensioning begins.

•         Green checkmark – Indicates that dimensioning was successful.

•         Yellow caution symbol – Indicates that the captured dimensions are out of range.

•         Red caution symbol – Indicates that the time-out was reached before dimensioning was completed or dimensioning was canceled by the user.

7| Start Dimensioning button – Select to begin dimensioning a parcel.

process. Dimensioning tips display at the top of the Viewfinder.
3| Start button – Starts the dimensioning process.
4| Information – Select to display legal, configuration, and other relevant information.
---|---
5| On-screen aimer – Use to identify the target parcel.
6| Progress arc – Indicates that dimensioning is in progress.

the Welcome screen.

Performing a Parcel Dimension
Use the MD Client to test the dimensioning service and understand the sample user interface (UI) of the app.

1. Open the MD Client app.
   The Welcome screen displays. Dimension values begin in a ready state as zeros.

2. Scan a barcode, if required.

3. Select IN or CM.

4. Select Start Dimensioning.
   A request is sent to the dimensioning service. The Viewfinder becomes active, but dimensioning has not started.

5. Select the Start icon.
   The Viewfinder remains active, and dimensions display as dashes. A progress arc rotates in place of the Start icon, indicating that dimensioning is active.

6. Use the Viewfinder to place the red on-screen aimer dot on the top surface of the parcel.
   When dimensioning results are obtained, the length, width, and height dimensions replace the dashes, and then the Confirmation screen displays. On the Confirmation screen, the Viewfinder displays a static image of the parcel with the captured dimensions indicated on the parcel axes. The length and width dimensions on drawn on the top edges and the height dimension are drawn to the side.

7. Select an option on the Confirmation screen.

   • Select the Retry button to return to the active Viewfinder screen and retry dimension capturing.
   • Select Confirm to confirm and accept the current results.
   • If dimensioning is not captured, the Confirm does not display. Select the Retry button to retry dimension capturing.
   • When the results are confirmed they display on the Welcome screen.
   • To begin a new dimensioning capture, select RESET. The dimensioning results are cleared.

Sample Feedback

The Framework provides helpful feedback to users during dimensioning and if dimensioning fails.

Positional Feedback

• During dimensioning, the Framework provides positional feedback as arrows in the corners of the Viewfinder. Text feedback can be added to the LOB app.
• The MD Client uses the following sample prompts and feedback during dimensioning.
  Text| Description
  ---|---
  Move Closer| Move the device closer. The parcel is too small in the Viewfinder’s Field-of-View (FOV).
  Move Farther Away| Move the device away. The parcel is overflowing the FOV.
  Tilt upwards| Tilt the device up. The parcel is out-of-bounds of the FOV.
  Tilt downwards| Tilt the device down. The parcel is out-of-bounds of the FOV.
  Move Left| Move to the left. The parcel is out-of-bounds of the FOV.
  Move Right| Move to the right. The parcel is out-of-bounds of the FOV.
  Timeout – Please retry or cancel| Retry or cancel the dimension capture. The parcel could not be dimensioned in the given timeframe.
  ---|---
  Capturing… keep parcel in frame| Keep the parcel within the FOV while dimensioning is in progress.

Advanced Feedback

• When NoDim indicators are returned to the app, the Framework provides advanced feedback at the top of the screen.
• For unsuccessful dimensioning attempts, the MD Client uses the following feedback after dimensioning.
  • Tilt the dimensioning device slightly. There is too much glare reflected back at the dimensioning device. For more information, see Minimum Range on page 11.
  • Place the parcel on a flat surface. The parcel is currently located in an unsupported environment. For more information, see Unsupported Parcels and Environments on page 8.
  • Make sure that there is a minimum of 12 cm (5 in.) of floor or counter space visible around all sides of the target parcel.
  • Make sure that is parcel is not covered in an unsupported material. For more information, see Unsupported Parcels and Environments on page 8.

Dimensioning Flow

The MD Client demonstrates typical dimensioning flows.

Successful Dimension In Range
In this scenario, dimensioning is successful while the parcel is in range.

1. Dimension values are all zeros. The user selects Start Dimensioning and the Viewfinder becomes active.
2. The user successfully captures the parcel in the Viewfinder. Dimensions and indicators display on the screen.
3. The user selects Confirm. Dimensions, indicators, and control return to the calling app.
4. The user selects the Refresh button to set the dimension values back to all zeros.

Successful Dimension Out of Range
In this scenario, dimensioning is successful while the parcel dimension is out of range. The parcel is out of range when the captured dimensions are either below the minimum specification or above the maximum specification.

1. Dimension values are all zeros. The user selects the Start Dimensioning button and the Viewfinder becomes active.
2. Dimensions are captured. Dimensions and indicators return to the calling app indicating that one or more measurements are out of range.
3. The user presses Retry to try again or selects the Confirm button to continue.
4. After measurements are confirmed, control returns to the calling app.
5. The user selects the Refresh button to return to the Welcome screen and set dimension values back to all zeros.

Unsuccessful Dimension Time-Out
In this scenario, dimensioning is unsuccessful because a time-out occurs before dimensions are captured.

1. Dimension values are all zeros. The user selects the Start Dimensioning button and the Viewfinder becomes active.
2. Dimensioning time-out occurs. The dimensions are indicated as NoDim.
3. The user selects Retry to try again or touches the Android Back button again to cancel dimensioning.
   • If the user selects Retry, the Viewfinder becomes active, and dimensioning starts.
   • If the user stops dimensioning by touching the Android Back button, the Welcome screen displays. NoDim indicators are returned to the app, indicating that no dimensions were captured.

Canceled Dimension
In this scenario, dimensioning is canceled by the user.

1. Dimension values are all zeros. The user selects the Start Dimensioning button and the Viewfinder becomes active.
2. The user stops dimensioning by touching the Android back button.
3. The user selects Retry to try again or touches the Android Back button again to cancel dimensioning.
4. Control returns to the calling app and the Welcome screen displays with all dimension values set to NoDim.
5. NoDim indicators are returned to the app, indicating that no dimensions were captured. The app is notified that dimensioning was canceled.

Positional Feedback
In this scenario, the user is too close to the parcel.

1. Dimension values are all zeros. The user selects the Start Dimensioning button and the Viewfinder becomes active.
2. The user receives a notification indicating that they should move the device farther away from the parcel.
3. The user successfully captures the parcel in the Viewfinder.
4. The user selects the Confirm button. Dimensions and indicators return to the calling app.
5. Control returns to the calling app and the results screen displays.
6. The user selects the Retry button to set the dimension values back to all zeros.

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>