Table of Contents

Get Parcel Data

7 June 2015

  • 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