[DOCS] explain geo-search listing parameters
Link to Documentation Issue
This page is fairly straight forward & useful. https://www.etsy.com/developers/documentation/reference/listing#method_findalllistingactive
What would you like to change?
Looking for more details on how the following geo parameters affect the search results & what are their interactions: lat/lon, geo_level & location. Some of following questions are special use-case specific perhaps not all answers should be fully documented there, but we couldn't find a technical Q&A forum to ask.
Namely wondering:
-
Do the
lat/lonparameters do a distance search under the hood? If so what are the default radius & units used? -
Does specifying a
geo_levelwithlat/lonconstraint the search area of results? ie:geo_level=city&lat=43.651070&lon=-79.347015gives results within for Toronto? Greater Toronto area or municipality proper? -
Is there any difference in search results when specifying
geo_level+lat/lonvsgeo_level+location? -
What is the syntax on location names or is it fuzzy? ie:
location=Montréalvslocation=Montrealvslocation=Island%20of%20Montreal(url encoded) give different results counts.
Why are you proposing this change?
Seeking general info to help implement focused search functionality in client apps.