Discovering Geospatial Indexes in Redis Using C++

Welcome! Now that we’ve explored bitmaps in Redis and learned how to handle individual bits, let's take a step further into the fascinating world of Geospatial Indexes. This lesson is a crucial part of our series on advanced Redis data structures designed to extend your data-handling capabilities.

In this lesson, you will discover the power of geospatial indexing in Redis. Specifically, you will learn:

1. How to add geographical coordinates (latitude and longitude) to a sorted set using the geoadd command.
2. How to calculate the distance between two locations using the geodist command.

To give you a sneak peek, here is an example of adding locations and calculating the distance between them using C++ and the hiredis library:

#include <iostream>
#include <hiredis/hiredis.h>

int main() {
    // Connect to the Redis server
    redisContext* context = redisConnect("127.0.0.1", 6379);
    if (context == nullptr || context->err) {
        if (context) {
            std::cerr << "Connection error: " << context->errstr << std::endl;
        } else {
            std::cerr << "Connection error: can't allocate Redis context" << std::endl;
        }
        return 1;
    }

    // Adding locations with geographic coordinates (longitude, latitude, name)
    redisReply* reply = (redisReply*)redisCommand(context, "GEOADD locations %f %f %s", 13.361389, 38.115556, "Palermo");
    freeReplyObject(reply);

    reply = (redisReply*)redisCommand(context, "GEOADD locations %f %f %s", 15.087269, 37.502669, "Catania");
    freeReplyObject(reply);

    // Calculating distance between locations
    reply = (redisReply*)redisCommand(context, "GEODIST locations %s %s %s", "Palermo", "Catania", "km");
    if (reply->type == REDIS_REPLY_STRING) {
        std::cout << "Distance between Palermo and Catania: " << reply->str << " km" << std::endl;
    } else {
        std::cout << "Failed to calculate the distance." << std::endl;
    }
    freeReplyObject(reply);

    // Free the context
    redisFree(context);

    return 0;
}

Let's discuss the methods used in this program:

GEOADD: This command adds one or more geospatial items, which consist of a longitude, latitude, and name, to a geospatial index stored within a sorted set.

• Syntax: GEOADD key longitude latitude member [longitude latitude member ...]
• Example in the code:
  • GEOADD locations 13.361389 38.115556 Palermo
  • GEOADD locations 15.087269 37.502669 Catania
  • These commands add "Palermo" and "Catania" to the "locations" geospatial index with their specific coordinates.

GEODIST: This command calculates the distance between two members in a geospatial index, providing the distance in the specified unit.

• Syntax: GEODIST key member1 member2 [unit]
• Example in the code:
  • GEODIST locations Palermo Catania km
  • This command calculates the distance between "Palermo" and "Catania" in the "locations" geospatial index, using "km" to denote that the answer should be in kilometers. You can also use mi if you want the distance in miles.