geopos.3valkey - Man Page
Returns the longitude and latitude of members from a geospatial index.
Synopsis
GEOPOS key member [member...]
Description
Return the positions (longitude,latitude) of all the specified members of the geospatial index represented by the sorted set at key.
Given a sorted set representing a geospatial index, populated using the GEOADD command, it is often useful to obtain back the coordinates of specified members. When the geospatial index is populated via GEOADD the coordinates are converted into a 52 bit geohash, so the coordinates returned may not be exactly the ones used in order to add the elements, but small errors may be introduced.
The command can accept a variable number of arguments so it always returns an array of positions even when a single element is specified.
Reply
Resp2
valkey-protocol(7) Array reply: An array where each element is a two elements array representing longitude and latitude (x,y) of each member name passed as argument to the command. Non-existing elements are reported as valkey-protocol(7) Nil reply elements of the array.
Resp3
valkey-protocol(7) Array reply: An array where each element is a two elements array representing longitude and latitude (x,y) of each member name passed as argument to the command. Non-existing elements are reported as valkey-protocol(7) Null reply elements of the array.
Complexity
O(1) for each member requested.
Acl Categories
@geo @read @slow
History
- Available since: 3.2.0
Examples
127.0.0.1:6379> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania" (integer) 2 127.0.0.1:6379> GEOPOS Sicily Palermo Catania NonExisting 1) 1) "13.36138933897018433" 2) "38.11555639549629859" 2) 1) "15.08726745843887329" 2) "37.50266842333162032" 3) (nil)
See Also
geoadd(3valkey), geodist(3valkey), geohash(3valkey), geosearch(3valkey), geosearchstore(3valkey)