Skip to content

Docs show different example results than what you see in the service now #194

@rmglennon

Description

@rmglennon

These are my notes as I went through documentation as part of #193.

Some examples in the documentation list the results that are returned from the request. Because these were added ages ago, they may differ from what is returned by the service right now. It's not too big of a deal in most cases and people should expect these to change over time, but the reverse with Tour Eiffel and autocomplete in Union Square are different enough to cause confusion if someone tried to compare the docs with the current results.

place
old href
https://search.mapzen.com/v1/place?
new href
https://mapzen.github.io/search-sandbox/?query=place&

reverse
old href
https://search.mapzen.com/v1/reverse?
new href
https://mapzen.github.io/search-sandbox/?query=reverse&

Tour Eiffel - # 3 (not # 1) result now for https://mapzen.github.io/search-sandbox/?query=reverse&point.lat=48.858268&point.lon=2.294471

search
old href
https://search.mapzen.com/v1/search?
new href
https://mapzen.github.io/search-sandbox/?query=search&

https://mapzen.github.io/search-sandbox/?query=search&text=YMCA gives different top 10 results (and 1 now is in Slovakia)

Every query on page has different top 10 result list

These results are a lot different: https://mapzen.github.io/search-sandbox/?query=search&text=YMCA&sources=oa

structured
old href
http://search.mapzen.com/v1/search/structured?
new href
https://mapzen.github.io/search-sandbox/?query=search/structured&

Note: + in URL is converted straight to + https://mapzen.github.io/search-sandbox/?query=search/structured&address=Rue+de+Rivoli&locality=Paris&region=France (and search is for Rue+de+Rivoli, so changed + to space so they show up correctly in text box)... I recall we used the + originally because of cached results.

so many examples in this section

autocomplete
old href
https://search.mapzen.com/v1/autocomplete?
new href
https://mapzen.github.io/search-sandbox/?query=autocomplete&

Union Square from SF is not returned at all
https://mapzen.github.io/search-sandbox/?query=autocomplete&focus.point.lat=37.7&focus.point.lon=-122.4&text=union square

Now gives all results in NY
https://mapzen.github.io/search-sandbox/?query=autocomplete&focus.point.lat=40.7&focus.point.lon=-73.9&text=union square

Different results with and without focus point (no Malta) https://mapzen.github.io/search-sandbox/?query=autocomplete&focus.point.lat=52.5&focus.point.lon=13.3&text=hard rock cafe

Different results
https://mapzen.github.io/search-sandbox/?query=autocomplete&sources=openaddresses&text=pennsylvania

Different results
https://mapzen.github.io/search-sandbox/?query=autocomplete&text=starbuck&layers=venue

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions