Why are we sunsetting older versions?

All GeoCodeRQ version uses internal calls to MapQuest and Lucene Index to get geographical coordinates. Mentioned Geocode v1 is planned to be sunset in Q3 2021, therefore Geocode v1 version must be sunset before that time. Sunsetting is part of Sabre Technical Transformation with new features.

What's New?

In GeoCodeRQ v4 we added capability to retrieve geographic details by adding PlaceByFreeText object in request.

How to migrate from previous REST version?

GeoCodeRQ v4 is backward compatible with previous version with the following new request object. It will have two properties, FreeText and searchMode. Therefore, migration from v1 – v4 version means adding PlaceByFreeText object in the REST request if required:

  "GeoCodeRequest": [
    {
      "GeoCodeRQ": {
        "PlaceByAddress": {
          "Street": "24 Madison St",
          "Zip": "10038",
          "City": "New York",
          "Region": "New York County",
          "State": "NY",
          "Country": "US"
        },
        "ResultSetConfig": {
          "maxResults": 10
        }
      }
    },
    {
      "GeoCodeRQ": {
        "PlaceById": {
          "Id": "DFW",
          "BrowseCategory": {
            "name": "AIR"
          }
        }
      }
    },
    {
      "GeoCodeRQ": {
        "PlaceByName": {
          "Name": "disney",
          "BrowseCategory": [
            {
              "name": "Sabre:CRL",
              "Limit": [
                {
                  "attribute": "vendor",
                  "to": "ZE"
                }
              ]
            }
          ],
          "NarrowDownResultsBy": {
            "City": "KISSIMMEE",
            "State": "FL",
            "Country": "US"
          }
        },
        "ResultSetConfig": {
          "maxResults": 10
        }
      }
    },
    {
      "GeoCodeRQ": {
        "PlaceByFreeText": {
          "FreeText": "Chicago, IL",
          "searchMode": "ADDRESS"
        },
        "ResultSetConfig": {
          "maxResults": 10
        }
      }
    }
  ]
}