bigdatacloud-reverse-geocodingv2/src/index.ts

Reverse geocoding browser-based typescript library, using free Bigdatacloud API

import axios from 'axios';
export * from './interface';
import { IGeocode, ILocation, IReverseGeocode } from './interface';

export default class ReverseGeocode {
  constructor(
    private options: IReverseGeocode = {
      api: 'https://api.bigdatacloud.net',
      endpoint: '/data/reverse-geocode-client',
      format: 'latitude=${lat}&longitude=${long}&localityLanguage=${lang}',
      language: 'en',
    },
  ) {}
  public async locate(coords: ILocation): Promise<IGeocode> {
    const queryString = (this.options.format || '').replace(/(\${lat})|(\${long})|(\${lang})/g, match => {
      switch (match) {
        case '${lat}':
          return String(coords.lat);
        case '${long}':
          return String(coords.long);
        case '${lang}':
          return this.options.language || 'en';
      }
      return '';
    });
    const answer = await axios.get(`${this.options.api}${this.options.endpoint}?${queryString}`);
    return answer.data;
  }
}