Standard Disclaimer: This code is not official IDX Broker code. It does use their API, but in NO WAY is it supported by IDX Broker. DO NOT contact IDX Broker for any support of this code.
These can be created in an IDX Broker account and pulled via an API GET call for savedlinks. If you already have lats and longs you could just use those too.
In the url string that contains the lat and long points do not include the plus signs as this appears to cause an encoding issue. Instead use an empty space.
There is a limit to the amount of characters allowed. The max length that is allowed is 512 for the pgon parameter. The more complicated the polygon the longer the urls string will be. Adding additional filters will make this string even longer. Should you reach the limit a URL can handle, the savedlink may not function correctly. Simpler shapes are best. Shapes should be efficient in the amount of points used. Polygons lines should not intersect.
When saved links are called the query string is returned with plus signs which will probably get encoded as %2b and commas that will likely be encoded as %252C. Sending this plus sign encoding in a PUT call will not work. Nor will sending a plus sign like +. The API will accept it and return 200, but the polygon overlay will not be created in the IDX Broker system. Instead use an empty space. The commas do not appear to make a difference and are accepted either way.
Example that doesn't work:
"queryString":"pgon=>44.0811730583207%2B-123.09107780456544%252C44.07143046636492%2B-123.11905860900879%252C44.04774558163617%2B-123.1032657623291%252C44.0811730583207%2B-123.09107780456544&radius=&layerType=polygon&clat=42.25291778330197&clng=-88.35754394&zoom=13&idxID=a001&pt=1"
Example that also doesn't work:
"queryString":"pgon=>44.0811730583207+-123.09107780456544%252C44.07143046636492+-123.11905860900879%252C44.04774558163617+-123.1032657623291%252C44.0811730583207+-123.09107780456544&radius=&layerType=polygon&clat=42.25291778330197&clng=-88.35754394&zoom=13&idxID=a001&pt=1"
Example that will work:
"queryString":"pgon=>44.0811730583207 -123.09107780456544%252C44.07143046636492 -123.11905860900879%252C44.04774558163617 -123.1032657623291%252C44.0811730583207 -123.09107780456544&radius=&layerType=polygon&clat=42.25291778330197&clng=-88.35754394&zoom=13&idxID=a001&pt=1"
This method is not availabe in API version 1.0.4 as such in my php example in this repo, I specify the API version in the request header. This will ensure that this call will work even if any clients that have API 1.0.4 version set in their IDX Broker account.
This information would also apply to the POST method as well.