> ## Documentation Index > Fetch the complete documentation index at: https://upstash.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # GEOSEARCH > Search for members in an area. Use `GEOSEARCH` to find the members of a geospatial index that fall inside a circle or a rectangle. The center is either an existing member of the index (`FROMMEMBER`) or an explicit coordinate pair (`FROMLONLAT`). The area is either a circle of a given radius (`BYRADIUS`) or an axis-aligned box of a given width and height centered on that point (`BYBOX`), which is the shape to use when you are covering a map viewport rather than a "within N km" question. By default only member names come back. `WITHDIST` adds the distance from the center in the unit of the query, `WITHCOORD` the member's coordinates, and `WITHHASH` its raw geohash score. `ASC` and `DESC` sort by distance, and `COUNT` caps the number of results; adding `ANY` lets the server return as soon as it has enough matches, which is faster but no longer gives you the nearest ones. `GEOSEARCH` replaces the deprecated `GEORADIUS` and `GEORADIUSBYMEMBER` commands and is the command to use for new code. Use [`GEOSEARCHSTORE`](/docs/redis/commands/geo/geosearchstore) when the result should be stored instead of returned. ## Syntax ```redis theme={"system"} GEOSEARCH (FROMMEMBER | FROMLONLAT ) (BYRADIUS (m | km | ft | mi) | BYBOX (m | km | ft | mi)) [ASC | DESC] [COUNT [ANY]] [WITHCOORD] [WITHDIST] [WITHHASH] ``` ## Arguments | Argument | Required | Repeatable | Description | | ------------------------------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `` | Yes | No | Redis key targeted by the command. | | `(FROMMEMBER \| FROMLONLAT )` | Yes | No | Where to center the search: `FROMMEMBER` uses the stored position of an existing member, `FROMLONLAT` uses the given coordinates. | | `(BYRADIUS (m \| km \| ft \| mi) \| BYBOX (m \| km \| ft \| mi))` | Yes | No | The area to search: `BYRADIUS` a circle of the given radius, `BYBOX` an axis-aligned box of the given width and height centered on the search point. The unit is `m` (meters), `km` (kilometers), `ft` (feet), or `mi` (miles). | | `(ASC \| DESC)` | No | No | Sort the matches by distance from the center: `ASC` (nearest first) or `DESC` (farthest first). Unsorted when omitted. | | `COUNT [ANY]` | No | No | Return at most `` matches. `ANY` returns as soon as enough matches are found, instead of sorting every match first. | | `WITHCOORD` | No | No | Also return the longitude and latitude of each match. | | `WITHDIST` | No | No | Also return the distance from the center, in the requested unit. | | `WITHHASH` | No | No | Also return the raw 52-bit geohash score of each match. | ## Response The reply reports the result of the operation. Error replies have the same shape in RESP2 and RESP3 and are surfaced as exceptions by the SDKs below. | Protocol | Reply | | -------- | ---------------------------------------------------- | | RESP2 | Array of bulk-string members or member-detail arrays | | RESP3 | Array of bulk-string members or member-detail arrays | Client libraries often decode bulk strings, maps, sets, and numeric strings into language-native values. The table describes the Redis wire reply. ## Examples TCP examples use the TLS `REDIS_URL` from the Upstash console. REST examples use `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN`. ```bash theme={"system"} GEOSEARCH my-key FROMMEMBER member BYRADIUS 1.5 m ``` ```ts theme={"system"} import { Redis } from "@upstash/redis"; const redis = Redis.fromEnv(); const result = await redis.geosearch( "my-key", { type: "FROMMEMBER", member: "member" }, { type: "BYRADIUS", radius: 1.5, radiusType: "M" }, "ASC", ); console.log(result); ``` ```python theme={"system"} from upstash_redis import Redis redis = Redis.from_env() result = redis.geosearch("my-key", member="member", radius=1.5, unit="M") print(result) ``` ```ts theme={"system"} import Redis from "ioredis"; const redis = new Redis(process.env.REDIS_URL!); const result = await redis.geosearch("my-key", "FROMMEMBER", "member", "BYRADIUS", "1.5", "m"); console.log(result); ``` ```ts theme={"system"} import { createClient } from "redis"; const client = await createClient({ url: process.env.REDIS_URL }) .on("error", console.error) .connect(); const result = await client.geoSearch("my-key", "member", { radius: 1.5, unit: "m" }); console.log(result); ``` ```python theme={"system"} import os import redis client = redis.from_url(os.environ["REDIS_URL"]) result = client.geosearch("my-key", member="member", radius=1.5, unit="m") print(result) ``` ```go theme={"system"} package main import ( "context" "fmt" "os" "github.com/redis/go-redis/v9" ) func main() { opts, err := redis.ParseURL(os.Getenv("REDIS_URL")) if err != nil { panic(err) } client := redis.NewClient(opts) result, err := client.GeoSearch(context.Background(), "my-key", &redis.GeoSearchQuery{Member: "member", Radius: 1.5, RadiusUnit: "m"}).Result() if err != nil { panic(err) } fmt.Println(result) } ``` ```java theme={"system"} import java.net.URI; import redis.clients.jedis.Jedis; try (Jedis jedis = new Jedis(new URI(System.getenv("REDIS_URL")))) { Object result = jedis.geosearch("my-key", "member", 1.5, redis.clients.jedis.args.GeoUnit.M); System.out.println(result); } ``` ```rust theme={"system"} fn main() -> redis::RedisResult<()> { let url = std::env::var("REDIS_URL").expect("REDIS_URL is not set"); let client = redis::Client::open(url)?; let mut connection = client.get_connection()?; let mut command = redis::cmd("GEOSEARCH"); command.arg("my-key"); command.arg("member"); command.arg("1.5"); command.arg("m"); let result: redis::Value = command.query(&mut connection)?; println!("{result:?}"); Ok(()) } ``` ## Related topics - [GEOSEARCHSTORE](/docs/redis/commands/geo/geosearchstore.md) - [GEORADIUS_RO](/docs/redis/commands/geo/georadius-ro.md) - [GEORADIUSBYMEMBER_RO](/docs/redis/commands/geo/georadiusbymember-ro.md) - [GEORADIUS](/docs/redis/commands/geo/georadius.md) - [GEORADIUSBYMEMBER](/docs/redis/commands/geo/georadiusbymember.md)