Sorting the selection by the 34;name34; field.nvar result ymaps.geoQuery(polygons).sort(39;properties.name39;);nalert(39;New position of the first item: 39; result.

These are basic operations, and a corresponding function is defined for each of them in the API.

For example, you need to find geo objects that are located north of some geographical region (house, street, etc.).

Or you need to find out whether a geo object falls into the geographical region of another object.

The implementation of such tasks using standard API functions can lead to a significant expansion of the program code.

To simplify such tasks, the API has a built-in set of helper methods.

When using helper methods, you do not need to implement operations such as searching geo objects, detecting their position relative to each other, and many other operations.

As an example, the table below shows two ways of completing the same task.

Task: Make geo objects red if they fall within a draggable circle.

But make all other geo objects blue (see the example in the sandbox ).

The GeoQueryResult object is called a geo object selection and consists of data storage with a special structure.

The geo objects that actions will be performed on must first be added to this object.

This can be any type of geo objects: placemarks, circles, rectangles, collections of them, and so on.

To create a GeoQueryResult selection, use the geoQuery function.

For example, the data source may be the resulting data that will be received from the server.

Since processing the request and response takes some time, geoQuery will wait for the source to be ready before making the selection: When the server returns the result, geoQuery will process data and construct the selection based on it.nymaps.geoQuery( ymaps.geocode (39;Saint Petersburg39;)); Copied to clipboard The geoQuery function returns the GeoQueryResult selection that was formed.

Now various actions can be performed with its objects, using helper methods: add to the map, set properties or options, and so on.

The set of available methods for performing various operations with a selection and its geo objects is shown below: 1.

Methods that perform operations on the selection The selection is an ordered array of geo objects that have been selected by some criteria.

As with normal arrays, various actions can be performed with the selection, such as adding or removing objects, sorting, putting its items in reverse order, and so on.

The following methods are intended for use with an array of selected objects: add Adds new objects to the selection.

It does not change the original GeoQueryResult selection, but creates a new one that contains the resulting set of geo objects.

It does not change the original selection, but creates a new one that contains the resulting set of geo objects.

Map Yandex