Package ru.bitel.bgbilling.plugins.gar.common.service

# Interface GarService

public interface GarService

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `static final String`
  `USER_AUTH_CONTRACT_KEY`
  `static final String`
  `USER_AUTH_PSWD_KEY`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `boolean`
  `checkLoadedRegion(int regionId)`
  Проверка загружен и обработан ли регион
  `EntityAttrAddress`
  `getAddressByCoordinates(Double latitude, Double longitude)`
  Получение адреса по координатам
  `String`
  `getCoordinatesByAddress(int houseId)`
  Попытка получения координат для переданного адреса
  `org.json.JSONObject`
  `getCoordinatesByAddressString(String address)`
  Попытка получения координат для переданного адреса
  `List<IdTitle>`
  `getCountries()`
  `GarAddressCity`
  `getGarCityInfoByCityId(long cityId)`
  Получение информации по населённому пункту по его ID
  `SearchResult<GarLoadedHistoryEntry>`
  `getLoadedHistory(Page page, Date dateFrom, Date dateTo)`
  `List<GarAddressStreet>`
  `getStreetsByCityId(long cityId)`
  Список улиц для указанного населённого пункта
  `GarLoadedReport`
  `loadDataInDB(int countryId, GarAddressCity city, List<GarAddressStreet> streets, boolean streetWithHouses)`
  `String`
  `loadRegion(int regionId)`
  Отправка команды на сервер ГАР для загрузки региона в БД
  `List<IdTitle>`
  `regionList()`
  `List<IdTitle>`
  `searchCitiesByContainsName(int regionId, String namePart)`
  Получение списка населённых пунктов только с названием и id

- ## Field Details

  - ### USER_AUTH_CONTRACT_KEY

    static final String USER_AUTH_CONTRACT_KEY
    See Also:
      - Constant Field Values

  - ### USER_AUTH_PSWD_KEY

    static final String USER_AUTH_PSWD_KEY
    See Also:
      - Constant Field Values

- ## Method Details

  - ### regionList

    List<IdTitle> regionList() throws ru.bitel.bgbilling.common.BGException
    Returns:
      Список всех регионов
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### searchCitiesByContainsName

    List<IdTitle> searchCitiesByContainsName(int regionId, String namePart) throws ru.bitel.bgbilling.common.BGException
    Получение списка населённых пунктов только с названием и id
    Parameters:
      `regionId` -
      `namePart` -
    Returns:
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### getStreetsByCityId

    List<GarAddressStreet> getStreetsByCityId(long cityId) throws ru.bitel.bgbilling.common.BGException
    Список улиц для указанного населённого пункта
    Parameters:
      `cityId` - ID населённого пункта
    Returns:
      список улиц
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### getGarCityInfoByCityId

    GarAddressCity getGarCityInfoByCityId(long cityId) throws ru.bitel.bgbilling.common.BGException
    Получение информации по населённому пункту по его ID
    Parameters:
      `cityId` - ID населённого пункта
    Returns:
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### checkLoadedRegion

    boolean checkLoadedRegion(int regionId) throws ru.bitel.bgbilling.common.BGException
    Проверка загружен и обработан ли регион
    Parameters:
      `regionId` - ID проверяемого региона
    Returns:
      true - если загружен и обработан

  - ### loadDataInDB

    GarLoadedReport loadDataInDB(int countryId, GarAddressCity city, List<GarAddressStreet> streets, boolean streetWithHouses) throws ru.bitel.bgbilling.common.BGException
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### getCountries

    List<IdTitle> getCountries() throws ru.bitel.bgbilling.common.BGException
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### loadRegion

    String loadRegion(int regionId) throws ru.bitel.bgbilling.common.BGException
    Отправка команды на сервер ГАР для загрузки региона в БД
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### getLoadedHistory

    SearchResult<GarLoadedHistoryEntry> getLoadedHistory(Page page, Date dateFrom, Date dateTo) throws ru.bitel.bgbilling.common.BGException
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### getCoordinatesByAddressString

    org.json.JSONObject getCoordinatesByAddressString(String address) throws ru.bitel.bgbilling.common.BGException
    Попытка получения координат для переданного адреса
    Parameters:
      `address` - строка с адресов вида: "Россия, Уфа, улица Ленина, 120"
    Returns:
      json с координатами, пример: { "latitude":54.7412289, "longitude"55.9560197, "title":"120, улица Ленина, Советский район, Уфа, городской округ Уфа, Башкортостан, Приволжский федеральный округ, 450000, Россия" }
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### getCoordinatesByAddress

    String getCoordinatesByAddress(int houseId) throws ru.bitel.bgbilling.common.BGException
    Попытка получения координат для переданного адреса
    Parameters:
      `address` - строка с адресов вида: "Россия, Уфа, улица Ленина, 120"
    Returns:
      json с координатами, пример: { "latitude":54.7412289, "longitude"55.9560197, "title":"120, улица Ленина, Советский район, Уфа, городской округ Уфа, Башкортостан, Приволжский федеральный округ, 450000, Россия" }
    Throws:
      `ru.bitel.bgbilling.common.BGException`

  - ### getAddressByCoordinates

    EntityAttrAddress getAddressByCoordinates(Double latitude, Double longitude) throws ru.bitel.bgbilling.common.BGException
    Получение адреса по координатам
    Parameters:
      `latitude` - широта
      `longitude` - долгота
    Returns:
      json c адресом в формате: { "latitude":54.7412289, "longitude"55.9560197, "title":"120, улица Ленина, Советский район, Уфа, городской округ Уфа, Башкортостан, Приволжский федеральный округ, 450000, Россия" }
    Throws:
      `ru.bitel.bgbilling.common.BGException`