universal-geocoder/src/provider/locationiq/LocationIQGeocodeQuery.ts

Universal geocoding abstraction server-side and client-side with multiple built-in providers

import { GeocodeQuery, GeocodeQueryObject } from "query";

export interface LocationIQGeocodeQueryObject extends GeocodeQueryObject {
  readonly countryCodes?: string[];
  readonly excludePlaceIds?: number[];
  readonly bounded?: boolean;
  readonly dedupe?: boolean;
}

export default class LocationIQGeocodeQuery extends GeocodeQuery {
  private readonly countryCodes?: string[];

  private readonly excludePlaceIds?: number[];

  private readonly bounded?: boolean;

  private readonly dedupe?: boolean;

  protected constructor({
    countryCodes,
    excludePlaceIds,
    bounded,
    bounds,
    dedupe,
    ...geocodeQueryObject
  }: LocationIQGeocodeQueryObject) {
    super({ bounds, ...geocodeQueryObject });
    this.countryCodes = countryCodes;
    this.excludePlaceIds = excludePlaceIds;
    if (bounded && !bounds) {
      throw new Error(
        'The "bounded" parameter can only be used with the "bounds" parameter.'
      );
    }
    this.bounded = bounded;
    this.dedupe = dedupe;
  }

  public static create(
    object: LocationIQGeocodeQueryObject
  ): LocationIQGeocodeQuery {
    return new this(object);
  }

  public toObject(): LocationIQGeocodeQueryObject {
    return {
      ...super.toObject(),
      countryCodes: this.countryCodes,
      excludePlaceIds: this.excludePlaceIds,
      bounded: this.bounded,
      dedupe: this.dedupe,
    };
  }

  public withCountryCodes(countryCodes: string[]): LocationIQGeocodeQuery {
    return new LocationIQGeocodeQuery({ ...this.toObject(), countryCodes });
  }

  public getCountryCodes(): undefined | string[] {
    return this.countryCodes;
  }

  public withExcludePlaceIds(
    excludePlaceIds: number[]
  ): LocationIQGeocodeQuery {
    return new LocationIQGeocodeQuery({ ...this.toObject(), excludePlaceIds });
  }

  public getExcludePlaceIds(): undefined | number[] {
    return this.excludePlaceIds;
  }

  public withBounded(bounded: boolean): LocationIQGeocodeQuery {
    return new LocationIQGeocodeQuery({ ...this.toObject(), bounded });
  }

  public getBounded(): undefined | boolean {
    return this.bounded;
  }

  public withDedupe(dedupe: boolean): LocationIQGeocodeQuery {
    return new LocationIQGeocodeQuery({ ...this.toObject(), dedupe });
  }

  public getDedupe(): undefined | boolean {
    return this.dedupe;
  }
}