/// <summary>
        /// Search settlements by name.
        /// Create request to 'SearchSettlements' Nova Poshta service method.
        /// Documentation: https://devcenter.novaposhta.ua/docs/services/556d7ccaa0fe4f08e8f7ce43/operations/58e5ebeceea27017bc851d67
        /// </summary>
        /// <param name="settlementName">Searched name</param>
        /// <param name="limit">Quantity</param>
        /// <returns>Settlements list</returns>
        public virtual IResponseEnvelope <SettlementsSearchResponse.ResponseItem> SearchSettlements(string settlementName, int limit = 100)
        {
            var request = new SettlementsSearchRequest()
            {
                SettlementName = settlementName,
                Limit          = limit
            };

            return(SearchSettlements(request));
        }
        /// <summary>
        /// Search settlements by name.
        /// Create request to 'SearchSettlements' Nova Poshta service method.
        /// Documentation: https://devcenter.novaposhta.ua/docs/services/556d7ccaa0fe4f08e8f7ce43/operations/58e5ebeceea27017bc851d67
        /// </summary>
        /// <param name="request">Search settlement request method properties</param>
        /// <returns>Settlements list</returns>
        public virtual IResponseEnvelope <SettlementsSearchResponse.ResponseItem> SearchSettlements(SettlementsSearchRequest request)
        {
            var fullRequestBody = new RequestEnvelope <SettlementsSearchRequest>()
            {
                ApiKey           = _novaPoshtaGateway.ApiKey,
                CalledMethod     = "searchSettlements",
                ModelName        = MODEL,
                MethodProperties = request
            };

            var response = _novaPoshtaGateway.CreateRequest <SettlementsSearchRequest, SettlementsSearchResponse>(fullRequestBody);

            return(response);
        }