Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

google places javadoc not found 404 & how to use API-KEY undocumented #10904

Open
mh-trimble opened this issue May 31, 2024 · 3 comments
Open
Assignees
Labels
priority: p2 Moderately-important priority. Fix may not be included in next release. type: docs Improvement to the documentation for an API.

Comments

@mh-trimble
Copy link

the javadocs linked for this library are not found:

https://cloud.google.com/java/docs/reference/google-maps-places/latest/overview

also https://developers.google.com/maps/documentation/places/web-service/get-api-key says that you can use an api key, but don't understand how to use an API key in the context of the library

@lqiu96 lqiu96 added type: bug Error or flaw in code with unintended results or allowing sub-optimal usage patterns. priority: p2 Moderately-important priority. Fix may not be included in next release. labels May 31, 2024
@lqiu96
Copy link
Contributor

lqiu96 commented May 31, 2024

Hi @mh-trimble, thanks for reporting this. I asked around internally and I believe the reference documentation for maps libraries are in the process of being migrated to the new URL (it may be something like: developers.google.com/maps/reference/documentation/{places|routing|address}/...) and should be up in the next few months. Apologies that the transition hasn't been smooth. Can you point us to the place where you found https://cloud.google.com/java/docs/reference/google-maps-places/latest/overview?

Also, regarding API-Keys: I believe our client libraries don't have the best built-in support for Api-Keys (as of now). I think we have a way to enable it and are looking into ways to make this better.

CC: @blakeli0 @alicejli if you have a way enable ApiKeys now for client libraries and any updates regarding ApiKeys in general.

@mh-trimble
Copy link
Author

Here is the link to the "javadocs" in the readme

[javadocs]: https://cloud.google.com/java/docs/reference/google-maps-places/latest/overview

@blakeli0 blakeli0 added api: docs Issues related to the Docs API API. type: docs Improvement to the documentation for an API. and removed type: bug Error or flaw in code with unintended results or allowing sub-optimal usage patterns. api: docs Issues related to the Docs API API. labels Jun 4, 2024
@blakeli0
Copy link
Contributor

blakeli0 commented Jun 4, 2024

I agree it's not straightforward to set up API Keys at this moment, and it is not documented either. I created a separate issue #10921 to track the documentation effort.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
priority: p2 Moderately-important priority. Fix may not be included in next release. type: docs Improvement to the documentation for an API.
Projects
None yet
Development

No branches or pull requests

3 participants