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

[mh-trimble]

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]

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]

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]

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.

[lqiu96]

Closing this issue as the maps documentation cannot be published for now. Will update with more information when we get it.