Geolocation Services

Cloud CMS provides geolocation information look up services that can be used to determine geographic information for a given IP address or set of coordinates.

In many places, Cloud CMS automatically utilizes these geolocation services for you. In places where geolocation information is stored on your content instances, geolocation data can automatically be looked up and applied using Cloud CMS features.

In addition, you can invoke the API directly to look up geolocation information for a given IP Address or set of geolocation coordinates.

IP Address

To look up geolocation information for a given IP address, use the following method:

GET /geolocation/resolve/ip?ip={ipAddress}

For example, you might do:

GET /geolocation/resolve/ip?ip=128.253.180.2

And you'll get back an object like this:

{
    resolved: true,
    info: {
        continentCode: "NA",
        continentName: "North America",
        countryCode: "US",
        countryName: "United States",
        cityCode: "ithaca",
        cityName: "Ithaca",
        regionCode: "NY",
        regionName: "New York",
        postalCode: "14853",
        latitude: "42.4485",
        longitude: "-76.4804"
    },
    ok: true
}

If geolocation information can be resolved for a given IP Address, resolved will be true. If nothing can be determined for the given IP Address, resolved will be false and no info will be returned.