gis:find-one-feature

gis:find-one-feature vector-dataset property-name specified-value

Reports the first VectorFeature in the dataset whose value for the property property-name matches the given string or number. Reports nobody if no matching VectorFeature is found.

For strings, Value comparison is not case sensitive, and the wildcard character ”*” will match any number of occurrences (including zero) of any character. Features are searched in the order that they appear in the data file that was the source of the dataset, and searching stops as soon as a match is found.

For numbers, beware that there are some numbers that are too big to be represented as an integer in NetLogo, so if you want to be able to identify features based on a unique ID, keep the IDs you use on the relatively small side to play it safe. Any number that can fit into a 32 bit unsigned integer will work, but any larger than 10^14 and you could run into issues. (Helpfully, the NetLogo app will warn you if you try to type one of these too-large numbers into the editor if you want to check.)