A destination provides hierarchical context about a place, which allows you to, for example, + * find apartment buildings within a larger apartment complex and vice versa. It also provides + * navigation points suitable for use cases such as ridesharing or delivery. + * + *
This class provides the ability to make remote calls to the backing service through method + * calls that map to API methods. Sample code to get started: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DestinationServiceClient destinationServiceClient = DestinationServiceClient.create()) {
+ * SearchDestinationsRequest request =
+ * SearchDestinationsRequest.newBuilder()
+ * .addAllTravelModes(new ArrayList())
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * SearchDestinationsResponse response = destinationServiceClient.searchDestinations(request);
+ * }
+ * }
+ *
+ * Note: close() needs to be called on the DestinationServiceClient object to clean up resources + * such as threads. In the example above, try-with-resources is used, which automatically calls + * close(). + * + *
| Method | + *Description | + *Method Variants | + *
|---|---|---|
SearchDestinations |
+ * This method performs a destination lookup and returns a list of destinations. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
See the individual methods for example code. + * + *
Many parameters require resource names to be formatted in a particular way. To assist with + * these names, this class includes a format method for each type of name, and additionally a parse + * method to extract the individual identifiers contained within names that are returned. + * + *
This class can be customized by passing in a custom instance of DestinationServiceSettings to + * create(). For example: + * + *
To customize credentials: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DestinationServiceSettings destinationServiceSettings =
+ * DestinationServiceSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * DestinationServiceClient destinationServiceClient =
+ * DestinationServiceClient.create(destinationServiceSettings);
+ * }
+ *
+ * To customize the endpoint: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DestinationServiceSettings destinationServiceSettings =
+ * DestinationServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * DestinationServiceClient destinationServiceClient =
+ * DestinationServiceClient.create(destinationServiceSettings);
+ * }
+ *
+ * To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over + * the wire: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DestinationServiceSettings destinationServiceSettings =
+ * DestinationServiceSettings.newHttpJsonBuilder().build();
+ * DestinationServiceClient destinationServiceClient =
+ * DestinationServiceClient.create(destinationServiceSettings);
+ * }
+ *
+ * Please refer to the GitHub repository's samples for more quickstart code snippets. + */ +@Generated("by gapic-generator-java") +public class DestinationServiceClient implements BackgroundResource { + private final DestinationServiceSettings settings; + private final DestinationServiceStub stub; + + /** Constructs an instance of DestinationServiceClient with default settings. */ + public static final DestinationServiceClient create() throws IOException { + return create(DestinationServiceSettings.newBuilder().build()); + } + + /** + * Constructs an instance of DestinationServiceClient, using the given settings. The channels are + * created based on the settings passed in, or defaults for any settings that are not set. + */ + public static final DestinationServiceClient create(DestinationServiceSettings settings) + throws IOException { + return new DestinationServiceClient(settings); + } + + /** + * Constructs an instance of DestinationServiceClient, using the given stub for making calls. This + * is for advanced usage - prefer using create(DestinationServiceSettings). + */ + public static final DestinationServiceClient create(DestinationServiceStub stub) { + return new DestinationServiceClient(stub); + } + + /** + * Constructs an instance of DestinationServiceClient, using the given settings. This is protected + * so that it is easy to make a subclass, but otherwise, the static factory methods should be + * preferred. + */ + protected DestinationServiceClient(DestinationServiceSettings settings) throws IOException { + this.settings = settings; + this.stub = ((DestinationServiceStubSettings) settings.getStubSettings()).createStub(); + } + + protected DestinationServiceClient(DestinationServiceStub stub) { + this.settings = null; + this.stub = stub; + } + + public final DestinationServiceSettings getSettings() { + return settings; + } + + public DestinationServiceStub getStub() { + return stub; + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * This method performs a destination lookup and returns a list of destinations. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DestinationServiceClient destinationServiceClient = DestinationServiceClient.create()) {
+ * SearchDestinationsRequest request =
+ * SearchDestinationsRequest.newBuilder()
+ * .addAllTravelModes(new ArrayList())
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * SearchDestinationsResponse response = destinationServiceClient.searchDestinations(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final SearchDestinationsResponse searchDestinations(SearchDestinationsRequest request) {
+ return searchDestinationsCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * This method performs a destination lookup and returns a list of destinations.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DestinationServiceClient destinationServiceClient = DestinationServiceClient.create()) {
+ * SearchDestinationsRequest request =
+ * SearchDestinationsRequest.newBuilder()
+ * .addAllTravelModes(new ArrayList())
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * ApiFuture future =
+ * destinationServiceClient.searchDestinationsCallable().futureCall(request);
+ * // Do something.
+ * SearchDestinationsResponse response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableThe default instance has everything set to sensible defaults: + * + *
The builder of this class is recursive, so contained classes are themselves builders. When + * build() is called, the tree of builders is called to create the complete settings object. + * + *
For example, to set the + * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings) + * of searchDestinations: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DestinationServiceSettings.Builder destinationServiceSettingsBuilder =
+ * DestinationServiceSettings.newBuilder();
+ * destinationServiceSettingsBuilder
+ * .searchDestinationsSettings()
+ * .setRetrySettings(
+ * destinationServiceSettingsBuilder
+ * .searchDestinationsSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ * .setMaxAttempts(5)
+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ * .setRetryDelayMultiplier(1.3)
+ * .setRpcTimeoutMultiplier(1.5)
+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
+ * .build());
+ * DestinationServiceSettings destinationServiceSettings =
+ * destinationServiceSettingsBuilder.build();
+ * }
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://docs.cloud.google.com/java/docs/client-retries) for additional support in setting
+ * retries.
+ */
+@Generated("by gapic-generator-java")
+public class DestinationServiceSettings extends ClientSettingsNote: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction This class provides the ability to make remote calls to the backing service through method
+ * calls that map to API methods. Sample code to get started:
+ *
+ * Note: close() needs to be called on the GeocodeServiceClient object to clean up resources such
+ * as threads. In the example above, try-with-resources is used, which automatically calls close().
+ *
+ * GeocodeAddress This method performs an address geocode, which maps an address to a LatLng. It also provides structured information about the address. Request object method variants only take one parameter, a request object, which must be constructed before the call. geocodeAddress(GeocodeAddressRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. geocodeAddressCallable()
+ * GeocodeLocation This method performs a location geocode, which maps a LatLng to an address. It also provides structured information about the address. Request object method variants only take one parameter, a request object, which must be constructed before the call. geocodeLocation(GeocodeLocationRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. geocodeLocationCallable()
+ * GeocodePlace This method performs a geocode lookup using a place ID. Request object method variants only take one parameter, a request object, which must be constructed before the call. geocodePlace(GeocodePlaceRequest request)
+ * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. geocodePlaceCallable()
+ * See the individual methods for example code.
+ *
+ * Many parameters require resource names to be formatted in a particular way. To assist with
+ * these names, this class includes a format method for each type of name, and additionally a parse
+ * method to extract the individual identifiers contained within names that are returned.
+ *
+ * This class can be customized by passing in a custom instance of GeocodeServiceSettings to
+ * create(). For example:
+ *
+ * To customize credentials:
+ *
+ * To customize the endpoint:
+ *
+ * To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over
+ * the wire:
+ *
+ * Please refer to the GitHub repository's samples for more quickstart code snippets.
+ */
+@Generated("by gapic-generator-java")
+public class GeocodeServiceClient implements BackgroundResource {
+ private final GeocodeServiceSettings settings;
+ private final GeocodeServiceStub stub;
+
+ /** Constructs an instance of GeocodeServiceClient with default settings. */
+ public static final GeocodeServiceClient create() throws IOException {
+ return create(GeocodeServiceSettings.newBuilder().build());
+ }
+
+ /**
+ * Constructs an instance of GeocodeServiceClient, using the given settings. The channels are
+ * created based on the settings passed in, or defaults for any settings that are not set.
+ */
+ public static final GeocodeServiceClient create(GeocodeServiceSettings settings)
+ throws IOException {
+ return new GeocodeServiceClient(settings);
+ }
+
+ /**
+ * Constructs an instance of GeocodeServiceClient, using the given stub for making calls. This is
+ * for advanced usage - prefer using create(GeocodeServiceSettings).
+ */
+ public static final GeocodeServiceClient create(GeocodeServiceStub stub) {
+ return new GeocodeServiceClient(stub);
+ }
+
+ /**
+ * Constructs an instance of GeocodeServiceClient, using the given settings. This is protected so
+ * that it is easy to make a subclass, but otherwise, the static factory methods should be
+ * preferred.
+ */
+ protected GeocodeServiceClient(GeocodeServiceSettings settings) throws IOException {
+ this.settings = settings;
+ this.stub = ((GeocodeServiceStubSettings) settings.getStubSettings()).createStub();
+ }
+
+ protected GeocodeServiceClient(GeocodeServiceStub stub) {
+ this.settings = null;
+ this.stub = stub;
+ }
+
+ public final GeocodeServiceSettings getSettings() {
+ return settings;
+ }
+
+ public GeocodeServiceStub getStub() {
+ return stub;
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * This method performs an address geocode, which maps an address to a LatLng. It also provides
+ * structured information about the address.
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * Sample code:
+ *
+ * The default instance has everything set to sensible defaults:
+ *
+ * The builder of this class is recursive, so contained classes are themselves builders. When
+ * build() is called, the tree of builders is called to create the complete settings object.
+ *
+ * For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of geocodeAddress:
+ *
+ * Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction The interfaces provided are listed below, along with usage samples.
+ *
+ * ======================= DestinationServiceClient =======================
+ *
+ * Service Description: A service for retrieving destinations.
+ *
+ * A destination provides hierarchical context about a place, which allows you to, for example,
+ * find apartment buildings within a larger apartment complex and vice versa. It also provides
+ * navigation points suitable for use cases such as ridesharing or delivery.
+ *
+ * Sample for DestinationServiceClient:
+ *
+ * ======================= GeocodeServiceClient =======================
+ *
+ * Service Description: A service for performing geocoding.
+ *
+ * Sample for GeocodeServiceClient:
+ *
+ * This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public abstract class DestinationServiceStub implements BackgroundResource {
+
+ public UnaryCallable The default instance has everything set to sensible defaults:
+ *
+ * The builder of this class is recursive, so contained classes are themselves builders. When
+ * build() is called, the tree of builders is called to create the complete settings object.
+ *
+ * For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of searchDestinations:
+ *
+ * Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public abstract class GeocodeServiceStub implements BackgroundResource {
+
+ public UnaryCallable The default instance has everything set to sensible defaults:
+ *
+ * The builder of this class is recursive, so contained classes are themselves builders. When
+ * build() is called, the tree of builders is called to create the complete settings object.
+ *
+ * For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of geocodeAddress:
+ *
+ * Note: This method does not support applying settings to streaming methods.
+ */
+ public Builder applyToAllUnaryMethods(
+ ApiFunction This class is for advanced usage.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcDestinationServiceCallableFactory implements GrpcStubCallableFactory {
+
+ @Override
+ public This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcDestinationServiceStub extends DestinationServiceStub {
+ private static final MethodDescriptor This class is for advanced usage.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcGeocodeServiceCallableFactory implements GrpcStubCallableFactory {
+
+ @Override
+ public This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcGeocodeServiceStub extends GeocodeServiceStub {
+ private static final MethodDescriptor This class is for advanced usage.
+ */
+@Generated("by gapic-generator-java")
+public class HttpJsonDestinationServiceCallableFactory
+ implements HttpJsonStubCallableFactory This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public class HttpJsonDestinationServiceStub extends DestinationServiceStub {
+ private static final TypeRegistry typeRegistry = TypeRegistry.newBuilder().build();
+
+ private static final ApiMethodDescriptor This class is for advanced usage.
+ */
+@Generated("by gapic-generator-java")
+public class HttpJsonGeocodeServiceCallableFactory
+ implements HttpJsonStubCallableFactory This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public class HttpJsonGeocodeServiceStub extends GeocodeServiceStub {
+ private static final TypeRegistry typeRegistry = TypeRegistry.newBuilder().build();
+
+ private static final ApiMethodDescriptor{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create()) {
+ * GeocodeAddressRequest request =
+ * GeocodeAddressRequest.newBuilder()
+ * .setLocationBias(GeocodeAddressRequest.LocationBias.newBuilder().build())
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * GeocodeAddressResponse response = geocodeServiceClient.geocodeAddress(request);
+ * }
+ * }
+ *
+ *
+ *
+ *
+ *
+ *
+ * Method
+ * Description
+ * Method Variants
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * GeocodeServiceSettings geocodeServiceSettings =
+ * GeocodeServiceSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create(geocodeServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * GeocodeServiceSettings geocodeServiceSettings =
+ * GeocodeServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create(geocodeServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * GeocodeServiceSettings geocodeServiceSettings =
+ * GeocodeServiceSettings.newHttpJsonBuilder().build();
+ * GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create(geocodeServiceSettings);
+ * }
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create()) {
+ * GeocodeAddressRequest request =
+ * GeocodeAddressRequest.newBuilder()
+ * .setLocationBias(GeocodeAddressRequest.LocationBias.newBuilder().build())
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * GeocodeAddressResponse response = geocodeServiceClient.geocodeAddress(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final GeocodeAddressResponse geocodeAddress(GeocodeAddressRequest request) {
+ return geocodeAddressCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * This method performs an address geocode, which maps an address to a LatLng. It also provides
+ * structured information about the address.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create()) {
+ * GeocodeAddressRequest request =
+ * GeocodeAddressRequest.newBuilder()
+ * .setLocationBias(GeocodeAddressRequest.LocationBias.newBuilder().build())
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create()) {
+ * GeocodeLocationRequest request =
+ * GeocodeLocationRequest.newBuilder()
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .addAllTypes(new ArrayList
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final GeocodeLocationResponse geocodeLocation(GeocodeLocationRequest request) {
+ return geocodeLocationCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * This method performs a location geocode, which maps a LatLng to an address. It also provides
+ * structured information about the address.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create()) {
+ * GeocodeLocationRequest request =
+ * GeocodeLocationRequest.newBuilder()
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .addAllTypes(new ArrayList
+ */
+ public final UnaryCallable{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create()) {
+ * GeocodePlaceRequest request =
+ * GeocodePlaceRequest.newBuilder()
+ * .setPlace("place106748167")
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * GeocodeResult response = geocodeServiceClient.geocodePlace(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final GeocodeResult geocodePlace(GeocodePlaceRequest request) {
+ return geocodePlaceCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * This method performs a geocode lookup using a place ID.
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create()) {
+ * GeocodePlaceRequest request =
+ * GeocodePlaceRequest.newBuilder()
+ * .setPlace("place106748167")
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * ApiFuture
+ */
+ public final UnaryCallable
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * GeocodeServiceSettings.Builder geocodeServiceSettingsBuilder =
+ * GeocodeServiceSettings.newBuilder();
+ * geocodeServiceSettingsBuilder
+ * .geocodeAddressSettings()
+ * .setRetrySettings(
+ * geocodeServiceSettingsBuilder
+ * .geocodeAddressSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ * .setMaxAttempts(5)
+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ * .setRetryDelayMultiplier(1.3)
+ * .setRpcTimeoutMultiplier(1.5)
+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
+ * .build());
+ * GeocodeServiceSettings geocodeServiceSettings = geocodeServiceSettingsBuilder.build();
+ * }
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://docs.cloud.google.com/java/docs/client-retries) for additional support in setting
+ * retries.
+ */
+@Generated("by gapic-generator-java")
+public class GeocodeServiceSettings extends ClientSettings{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DestinationServiceClient destinationServiceClient = DestinationServiceClient.create()) {
+ * SearchDestinationsRequest request =
+ * SearchDestinationsRequest.newBuilder()
+ * .addAllTravelModes(new ArrayList
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GeocodeServiceClient geocodeServiceClient = GeocodeServiceClient.create()) {
+ * GeocodeAddressRequest request =
+ * GeocodeAddressRequest.newBuilder()
+ * .setLocationBias(GeocodeAddressRequest.LocationBias.newBuilder().build())
+ * .setLanguageCode("languageCode-2092349083")
+ * .setRegionCode("regionCode-1991004415")
+ * .build();
+ * GeocodeAddressResponse response = geocodeServiceClient.geocodeAddress(request);
+ * }
+ * }
+ */
+@Generated("by gapic-generator-java")
+package com.google.maps.geocode.v4;
+
+import javax.annotation.Generated;
diff --git a/java-maps-geocode/google-maps-geocode/src/main/java/com/google/maps/geocode/v4/stub/DestinationServiceStub.java b/java-maps-geocode/google-maps-geocode/src/main/java/com/google/maps/geocode/v4/stub/DestinationServiceStub.java
new file mode 100644
index 000000000000..0af21e975da7
--- /dev/null
+++ b/java-maps-geocode/google-maps-geocode/src/main/java/com/google/maps/geocode/v4/stub/DestinationServiceStub.java
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.maps.geocode.v4.stub;
+
+import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.maps.geocode.v4.SearchDestinationsRequest;
+import com.google.maps.geocode.v4.SearchDestinationsResponse;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * Base stub class for the DestinationService service API.
+ *
+ *
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * DestinationServiceStubSettings.Builder destinationServiceSettingsBuilder =
+ * DestinationServiceStubSettings.newBuilder();
+ * destinationServiceSettingsBuilder
+ * .searchDestinationsSettings()
+ * .setRetrySettings(
+ * destinationServiceSettingsBuilder
+ * .searchDestinationsSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ * .setMaxAttempts(5)
+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ * .setRetryDelayMultiplier(1.3)
+ * .setRpcTimeoutMultiplier(1.5)
+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
+ * .build());
+ * DestinationServiceStubSettings destinationServiceSettings =
+ * destinationServiceSettingsBuilder.build();
+ * }
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://docs.cloud.google.com/java/docs/client-retries) for additional support in setting
+ * retries.
+ */
+@Generated("by gapic-generator-java")
+@SuppressWarnings("CanonicalDuration")
+public class DestinationServiceStubSettings extends StubSettings
+ *
+ *
+ * {@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * GeocodeServiceStubSettings.Builder geocodeServiceSettingsBuilder =
+ * GeocodeServiceStubSettings.newBuilder();
+ * geocodeServiceSettingsBuilder
+ * .geocodeAddressSettings()
+ * .setRetrySettings(
+ * geocodeServiceSettingsBuilder
+ * .geocodeAddressSettings()
+ * .getRetrySettings()
+ * .toBuilder()
+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ * .setMaxAttempts(5)
+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ * .setRetryDelayMultiplier(1.3)
+ * .setRpcTimeoutMultiplier(1.5)
+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
+ * .build());
+ * GeocodeServiceStubSettings geocodeServiceSettings = geocodeServiceSettingsBuilder.build();
+ * }
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://docs.cloud.google.com/java/docs/client-retries) for additional support in setting
+ * retries.
+ */
+@Generated("by gapic-generator-java")
+@SuppressWarnings("CanonicalDuration")
+public class GeocodeServiceStubSettings extends StubSettings