google-maps-services-python icon indicating copy to clipboard operation
google-maps-services-python copied to clipboard

Please improve on the documentation.

Open theKoladeAkande opened this issue 5 years ago • 6 comments

Thanks for stopping by to let us know something could be better!


PLEASE READ

If you have a support contract with Google, please create an issue in the support console. This will ensure a timely response.

Discover additional support services for the Google Maps Platform, including developer communities, technical guidance, and expert support at the Google Maps Platform support resources page.

If your bug or feature request is not related to this particular library, please visit the Google Maps Platform issue trackers.

Check for answers on StackOverflow with the google-maps tag.


Is your feature request related to a problem? Please describe. A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Describe the solution you'd like A clear and concise description of what you want to happen.

Describe alternatives you've considered A clear and concise description of any alternative solutions or features you've considered.

Additional context Add any other context or screenshots about the feature request here.

theKoladeAkande avatar Jul 24 '20 20:07 theKoladeAkande

This issue has been automatically marked as stale because it has not had recent activity. Please comment here if it is still valid so that we can reprioritize. Thank you!

stale[bot] avatar Nov 21 '20 23:11 stale[bot]

This issue has been automatically marked as stale because it has not had recent activity. Please comment here if it is still valid so that we can reprioritize. Thank you!

stale[bot] avatar Jun 02 '21 16:06 stale[bot]

The Python documentation found here: https://googlemaps.github.io/google-maps-services-python/docs/index.html does not include the static_map() API. Users must look at the code to figure out how to use it. Also, there are 0 Python complete examples or use cases about how to use the googlemaps module in a Python environment--only a couple of code fragments.

MumblingFumbler avatar Sep 10 '21 18:09 MumblingFumbler

@MumblingFumbler and others,

Sorry the lack of response here. I am working from the bottom up with an OpenAPI specification for these APIs. You can view it at https://github.com/googlemaps/openapi-specification.

As the spec stabilizes I plan to followup with autogenerating client libraries and hope to replace this one which has become outdated.

jpoehnelt avatar Sep 10 '21 20:09 jpoehnelt

This issue has been automatically marked as stale because it has not had recent activity. Please comment here if it is still valid so that we can reprioritize. Thank you!

stale[bot] avatar Apr 16 '22 03:04 stale[bot]

Bump! The documentation for the Python Client is not up to par, there3 are no code examples anywhere.

virajvaidya avatar Jul 01 '22 01:07 virajvaidya

Hey @jpoehnelt @theKoladeAkande @virajvaidya @sanga Anything that needs to be done here? Please advise me on the work and I'll try and fix it up.

suryakapurothu avatar Oct 04 '22 15:10 suryakapurothu

I've noticed that docs haven't been generated since 3.0.2 and we're now on 4.9.0.

We've now added a docs.yml workflow but it hasn't been run yet.

wangela avatar Jan 26 '23 00:01 wangela

Generated and published docs for 4.10.0. https://googlemaps.github.io/google-maps-services-python/docs/index.html

Still missing static_map due to an error in docs generation, so leaving this open.

wangela avatar Jan 26 '23 20:01 wangela

Found the static_map() docs, the error didn't prevent them after all.

wangela avatar Jan 27 '23 00:01 wangela