com.google.maps.NearestRoadsApiRequest Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of google-maps-services Show documentation

Use the Google Maps Platform Web Services in Java! https://developers.google.com/maps/documentation/webservices/

The newest version!

package com.google.maps;

import com.google.gson.FieldNamingPolicy;
import com.google.maps.RoadsApi.RoadsResponse;
import com.google.maps.internal.ApiConfig;
import com.google.maps.internal.StringJoin;
import com.google.maps.model.LatLng;
import com.google.maps.model.SnappedPoint;

/** A request to the snap to roads API (part of Roads API). */
public class NearestRoadsApiRequest
    extends PendingResultBase {

  private static final ApiConfig NEAREST_ROADS_API_CONFIG =
      new ApiConfig("/v1/nearestRoads")
          .hostName(RoadsApi.API_BASE_URL)
          .supportsClientId(false)
          .fieldNamingPolicy(FieldNamingPolicy.IDENTITY);

  public NearestRoadsApiRequest(GeoApiContext context) {
    super(context, NEAREST_ROADS_API_CONFIG, RoadsResponse.class);
  }

  @Override
  protected void validateRequest() {
    if (!params().containsKey("points")) {
      throw new IllegalArgumentException("Request must contain 'path");
    }
  }

  /**
   * The points from which to snap to roads.
   *
   * @param points the point to be snapped
   * @return returns this {@link NearestRoadsApiRequest} for call chaining.
   */
  public NearestRoadsApiRequest points(LatLng... points) {
    return param("points", StringJoin.join('|', points));
  }
}