Get Parcel Data

7 June 2015

Release 8.22 - added the optional region parameter.

getparceldata (Commands)
Type	Corrade progressive command
Command	`getparceldata`
Description	The `getparceldata` command can be used to query a parcel at a certain `position` inside the simulator (or the current parcel that the bot is on if `position` is not specified) by following the Parcel structure.
Permissions	`land`
Parameters	`group`, `password`, `data`
Last Changes	Release 8.22 - added the optional `region` parameter.

The getparceldata command can be used to query a parcel at a certain position inside the simulator (or the current parcel that the bot is on if position is not specified) by following the Parcel structure.

Command Required Parameters Required Corrade Permissions Example

getparceldata

group, password, data

land

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // gets the name and the area
            // of the current parcel that
            // the bot is currently over
            "command", "getparceldata",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "data", wasListToCSV(
                [
                    "Name",
                    "Area"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);

Optional Parameters	Description
`position`	A positional vector that falls within a certain parcel.
`region`	Attempt to perform the command on the specified region by name. 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.

Examples

To check whether a parcel located in the local region at <194.54810, 70.12180, 23.94176> is for sale, one would issue the command:

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // gets the name and the area
            // of the current parcel that
            // the bot is currently over
            "command", "getparceldata",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "position", wasURLEscape("<194.54810, 70.12180, 23.94176>"),
            "data", wasListToCSV(
                [
                    "Name",
                    "Flags"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);

The command then returns the name of the parcel (Name) and the parcel flags:

command=getparceldata&time=2019-02-20T22:09:21.719511Z&data=Name,"Fun Games (Earn L$ with Virtual Fishing / Virtual Farming)",Flags,AllowFly,AllowOtherScripts,AllowLandmark,CreateObjects,UseBanList,SellParcelObjects,AllowGroupScripts,CreateGroupObjects,AllowAPrimitiveEntry,AllowGroupObjectEntry,AllowVoiceChat,UseEstateVoiceChan&success=True

Looking at the list flags returned:

Flags,AllowFly,AllowOtherScripts,AllowLandmark,CreateObjects,UseBanList,SellParcelObjects,AllowGroupScripts,CreateGroupObjects,AllowAPrimitiveEntry,AllowGroupObjectEntry,AllowVoiceChat,UseEstateVoiceChan

the ForSale flag is missing which means that the parcel is not for sale.

Notes

Please do not use AABMin and AABMax to compute descriptive point vectors with the purpose of enumerating parcels since that method will produce erroneous results. Instead, consider using the getregionparcellocations to enumerate parcels.

Table of Contents

Get Parcel Data

Examples

Notes