# Position

Position refers to the location or placement of the robot or its components within the playing field or its own coordinate system. It's a fundamental concept for understanding and controlling the robot's movements and interactions with its environment. The blocks in this section allow you to create position objects, manipulate these objects, and obtain information from these objects.

**Position.DistanceUnit**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcuMKSAeOwa51eoi8479aTG_moRDdywXo9tQIaNqPG6ql-E9GMHDlOYGWSl5S67Tdyj0hssJuW46LZbDz0o3TC68C0KN7s-mVK1KUBLLuo2j2g-g_l6tEky0C4LD9M0HnSVEHmNQcUu0lcX-GFzLEy7pOia?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns the distance unit used by the given position object.

**Position.X**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfIAbcmyBNJXukuwYvhDhsOQhksZ_DLhR6OfwmbNQzZP-vXrYzTrSiECy_fq3qkwYGyzfejNfwCnG8KtMFLUk8Hl4tcdpNFRC4MviUX9jLaH1sLn8Pe2W5D6IdDUx5s2i-nVtm5s9pQD9lIdNtMdbr3rGFs?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns X value of the position represented by a given position object.

**Position.Y**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdK9cNvY-ljQ24TQ15KpQdh-rXkeMOEFuQXd9EOuJ0JrzKQXrw3Nn-S0NuEvCBGBc2tNqQ5xeCZf8yl4pW8YKthmqzRFf-8sn9amREGWp4_du7n_oyNTv8F165uG9P6CAzv6dfv8Klb3CszH7Vzh_NC672Q?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns Y value of the position represented by a given position object.

**Position.Z**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfnKLALHJXZU0JH-dc9ZZYC4_XDvcV8QKDiIJFMTpnTg2MJYBBJ06oW6qFLKdo0rs84avhxI__6L87eOS03MHsyze350cT_vZLco-SpSUgCHHnG3GJ8ppNvLBf-0AOcobf_p-9zNtdNVCcUTFt8Qee1s6E?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns Z value of the position represented by a given position object.

**Position.AcquisitionTime**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXc0nSQaN_Pjcc6BTCEyoWlGbMMYLAYSR3PkJZajyVYUzgx0EKRx5M3BCA-9eQY5p9gOboJMvYnsqncdRzDOZ2yBkvHNQp9ou_U_08_11iEl3ECjRx2ciYXdsJOgxnCafCUp-hfykmm6aICLbgIkYgJvJ9E?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns acquisition time of a given position object.

**Position.toDistanceUnit**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeitFTyjOxuRjaA1YRoxUQSgAhlz7pNs5h1xk9RlYsS8oyEIrXXgKuvVQmx-LC7fkbpTbWrhHkVJNEFO4lUbi-fd64LnEl2vyqGr4ypxt0sqvFaR_ckbXw8xFZ8nK_wvkZucVYM8qKIyswfu3UR4Q2H3lU?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns a new position object based on a given position object and a new distance unit.

**toText**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXf4bOC_clD6PKKjtOrKQ0Ai16xWS23qDpfGe6iZCYBlRdsi0TJTkoVQNZLXzcLAD4Iv2nRBFRNRQ3RIkkcnfeFv0xrOZDVMCdeiRscNV_e4wE4jiXOSBxWP2fZM1I9CoDOKUb8GOEF4V9GFpQydxyvcQjU?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns a text representation of a given position object.

**new Position**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdV6FTZeQtQwjOJFRt6GwtXhxcsxPaSEBLjy1ELIQZihNyYuFyg0m4UN1qPOOkbcNW4hcuAg1RPKkQS5eTlCmeCa8hfCUKbDdK-hcQA8NvhO3FwXmmCcpz6qz-NZzTpCm-RBUS53hdOn7OLBeGceuAFnHlI?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns a new position object with all X, Y, Z values being 0.

**new Position (expanded)**

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcpiDprJPfGGbu84-Ft80Z61YHV23rJ-ymwQ4iPsyOe6LC1GX4Q7iMyliEUE19PBc3KM4wIfNgaZyOTofaxJ6JgEO3wCe6kiqzyLOPBVBtqxDaTlbE73sA03iHQUEk_KeYPDTgxCrWHhM4GrJtfLP1nSZ8T?key=hRw9bBhBfp1lHBJ7rUAI2Q)

Returns a new position object using the given distance using x, y and z values. It uses the current system time as the acquisition time.