search

googleapis / google-cloud-java

Google Cloud Client Library for Java
https://cloud.google.com/java/docs/reference
Apache License 2.0
1.89k stars 1.06k forks source link

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

Open mh-trimble opened 4 months ago

mh-trimble commented 4 months ago

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 commented 4 months ago

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 commented 4 months ago

Here is the link to the "javadocs" in the readme https://github.com/googleapis/google-cloud-java/blob/aa25967b6482694f8ad41011c023a87bc31686e8/java-maps-places/README.md?plain=1#L191

blakeli0 commented 4 months ago

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 https://github.com/googleapis/google-cloud-java/issues/10921 to track the documentation effort.