googlemaps / go-routespreferred Goto Github PK

Is your feature request related to a problem? Please describe.
Before ComputeRouteMatrix is generally available, there should be examples in the GAPIC libraries.

Describe the solution you'd like
Add a compute-route-matrix sample, much like compute-routes.

Describe alternatives you've considered
Use one sample to show both ComputeRoutes and ComputeRouteMatrix examples.

The following file is missing from this repository: .github/CODEOWNERS

Do not edit below:
meta: [.github/CODEOWNERS]

Is your feature request related to a problem? Please describe.
API Keys are explicitly not supported by the GAPIC libraries. While this can be worked around, the workaround is different for each language and generally pretty ugly. The GAPIC library samples should show OAuth usage instead of API Key usage.

Describe the solution you'd like
Change the sample code to use OAuth.

Describe alternatives you've considered
Continue to show API Key usage, or show both usages. - This will require work to figure out how to use API Keys in other GAPIC languages, and only serves to provide a more convenient but less secure authentication method.

Additional context
The Routes Preferred endpoint supports authentication via API Keys, OAuth, or Self-Signed JWTs. Both OAuth and Self-Signed JWTs are well-supported by GAPIC libraries.

The section is currently outdated, as authentication is no longer limited to API keys.

Current state of authentication support:

1. OAuth with service account credentials:
   1. Set by option.WithCredentialsFile(...).
   2. Set by environment variable GOOGLE_APPLICATION_CREDENTIALS.
   3. Set by AppEngine/Compute Engine environment. Note that your AppEngine/Compute Engine service account is likely not authorized to grant the routes preferred scope, so you'll have to update its scopes accordingly (https://cloud.google.com/compute/docs/access/create-enable-service-accounts-for-instances#changeserviceaccountandscopes). Also note that since we are not a cloud API, our scope will not appear on the cloud console and should be granted via gcloud CLI instead.
2. Self-signed JWT:
   • Set by option.WithAudiences("https://routespreferred.googleapis.com/"), same credentials as OAuth.
   • Note: This doesn't seem to work with credentials provided by the AppEngine/Compute Engine environment.
3. API Keys:
   • Unsupported in GAPIC libraries.