Get Avatar Positions

7 June 2015

Release 8.22 - added the optional region parameter.

getavatarpositions (Commands)
Type	Corrade progressive command
Command	`getavatarpositions`
Description	The `getavatarpositions` returns a `CSV` list of avatar names by `UUID`s by positions within the current region that the bot is on.
Permissions	`interact`
Parameters	`group`, `password`, `entity`
Last Changes	Release 8.22 - added the optional `region` parameter.

The getavatarpositions returns a CSV list of avatar names by UUIDs by positions within the current region that the bot is on.

Command Required Parameters Required Corrade Permissions Example

Command	Required Parameters	Required Corrade Permissions	Example
`getavatarpositions`	`group`, `password`, `entity`	`interact`	llInstantMessage(CORRADE, wasKeyValueEncode( [ // returns the avatar positions // in the current region "command", "getavatarpositions", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "entity", "region", "callback", wasURLEscape(URL) ] ) );

getavatarpositions

group, password, entity

interact

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // returns the avatar positions
            // in the current region
            "command", "getavatarpositions",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "entity", "region",
            "callback", wasURLEscape(URL)
        ]
    )
);

Parameter	Possible Value	Sub-Parameter	Sub-Parameter Value	Description
`entity`	`region`			Gets the avatar positions in the current region.
`entity`	`parcel`	`position`	A positional vector within the parcel to examine.	Gets the avatar positions in the current parcel.

Optional Parameter	Possible Values	Description
`region`	A string representing a region name.	Attempt to perform the command on the specified region. Note that Corrade must be connected to that region. If in doubt, please use the getconnectedregions command to determine whether the region you want to specify is currently connected.

Notes

The positions returned by this command are coarse positions and not exact - the z component will be capped at about $1024m$
If exact positions are required then the following options might work given the usage case:
- Use the getregiontop command and query the region colliders provided that the bot has estate rights.
- Use the mapfiend command or the tracker notification to determine the exact position of an avatar provided that the avatar has granted the mapping permission.
- Use the getavatarsdata command and set the range to a desired distance.
- Use llSensor or llSensorRepeat to supplement the data returned by "getavatarpositions" (this is the way some viewers implement their own radar and object tracking systems with a helper in-world script).