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

Make documentation linkage between api names easier to find/see

Open henri-chat-noir opened this issue 4 years ago • 5 comments

First off, really effective wrapper and complete on all the Google APIs. No complaints from my usage so far.

This is very trivial, but for complete newbies like me, might be helpful. Remembering that Google has a lot to say about it's APIs that might not be captured in this documentation (and shouldn't be), e.g. if you include a region code in a Places request, the country name is excluded from formatted address. So . . .

Perhaps in documentation and/or code base doc strings, add reference to Google names for API? For instance, took me a long time to work through that "places" is the same as "textsearch" because "textsearch" doesn't appear in the code. A formatted print string separates "text" and "search", so references on repo pretty sparse.

Small idea. No big deal of course, but thought I'd try to contribute something back.

henri-chat-noir avatar Feb 03 '21 14:02 henri-chat-noir

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 03 '21 19:06 stale[bot]

Closing this. Please reopen if you believe it should be addressed. Thank you for your contribution.

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

Reopening as valid. We could edit the description of each subclass of Client (e.g. Client.directions()) to include a link to the corresponding documentation on developers.google.com (e.g. Directions API documentation). For directions, the description is defined toward the beginning of directions.py.

wangela avatar Jan 27 '23 20:01 wangela

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 18 '23 12:06 stale[bot]

Still valid!

connorjoleary avatar Nov 12 '23 18:11 connorjoleary